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Revision Description 
Feb. 1976 - Original distribution 
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Changes are not noted by change bars. 


C Sept. 1977 - Reprint with revision. This edition obsoletes 
all previous editions. Significant changes and additions have 
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PREFACE 


This publication describes how to operate a Data General Eclipse being 

used as either an on-site or remote batch entry station for the CRAY-1 
Computer System. Section 1 presents an overview of the hardware and 
software system configurations. Section 2 summarizes often-used procedures. 
Section 3 describes station commands in general and then presents them in 
detail in alphabetical order. , 


Section 4 tells how to operate the off-line features provided by Cray 
Research, Inc. which are available under the Data General RDOS Operating 
System. 


Section 5 is intended primarily for the batch user and tells how a job 
deck or dataset is prepared for transmission to the CRAY-1. 
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INTRODUCTION 1 


This manual describes the operational requirements of a Data General ECLIPSE 
5~200- Computer and associated peripheral devices when used as either an 
on-site or remote job entry station for the Cray Research, Inc. CRAY-1® 
Computer System. A job entry station is a computer system that collects 
and presents data to the CRAY-1 for processing and receives output from 
the CRAY-1 for distribution to slower devices. An on-site station is 
connected directly to a CRAY-1 channel; in addition to acting as a job 
entry station it may gather data from or distribute data to one or more 
second-level processors referred to as remote job entry stations. An on- 
site station can act as a data concentrator for one to four remote sta- 
tions connected via telephone lines. 


An Eclipse connected to the CRAY-1 through the MCU cable provides operator 
functions reserved to the Maintenance Control Unit (MCU). These functions 
are available on-site or remotely. 


HARDWARE CONFIGURATION 


The following types of devices may be associated with the Eclipse computer 
when* used as a station: 

TEC Model 1440 Data Screen 

TEC Model 455 Data Screen be 

Caicomp Model 144D Disk Drive 

Documation Model M-1000 Card Reader 

Data General 9-track, 800 bpi Magnetic Tape Unit 

Gould 5000 Printer/Plotter 


Not all of these devices are used for all applications and the number of 
devices of each type is site dependent. 


SETS 


* ECLIPSE is a registered Pragenark of the Data General Corporation, 
Southboro, Mass. 


** Data Screen is a trademark of TEC, Inc. Tucson, Arizona. 
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Figures 1-1 and 1-2 illustrate the configurations for an on-site station 
and a remote station, respectively. 
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Figure 1-1. On-site station configuration 
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Figure 1-2. Remote station configuration 
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SOFTWARE ‘CONFIGURATION 


Three versions of station software are supplied by Cray Research: on-site 
station, concentrator, and remote station. The versions are operationally 
the same (with the exception of MCU and communications operations), so for 
the most part, any differences are transparent to the operator. 


The Eclipse computer operates under control of the Data General RDOS un- 
mapped operating system. This system is described in detail in the fol- 
lowing Data General publications: 


RDOS Reference Manual Data General publication 093-000129 
RDOS User's Manual Data General publication 093-000075 
RDOS CLI Reference Manual Data General publication 093-000109 


RDOS has two user program areas: foreground and background. The Eclipse 
station software supplied by Cray Research can execute in either of the 
areas. 


The operator initializes RDOS and submits commands to RDOS via the TEC 1440 
data screen to bring the station to.an operational state. The RDOS routine 
that translates the commands is known as the Command Line Interpreter 
(CLI). CLI commands allow the operator to select programs to run in the 
foreground and background areas of the computer and to.control files and 
devices local to the computer. CLI permits the operator to perform a 
variety of off-line utility functions as described in general in section 

4 of this publication and described in detail in the Data General CLI 
Reference Manual. When the background area is in use, CLI is deactivated. 


Section 2 of this publication describes the operator procedures for 
initializing RDOS and loading and executing the station software. 
Operator communication with the station and with the CRAY-1 Operating 
System is through the TEC Model 455 Data Screen. Station commands 
entered at this device are processed locally by station software or are 
passed to the CRAY-1. The CRAY-1 Operating System performs the requested 
function and returns messages and data to the station. 
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OPERATOR STATIONS 


One station in the CRAY-1 system is designated as the System Operator 
Station and is privileged to perform functions not allowed at any other 
station. - ae 


The mainframe identifier of the system operator station is specified as 
an assembly parameter of the CRAY-OS Operating System. A station that 
is currently the system operator station can manipulate any jobs in the 


“system. “As one of tts priviteged functtons, it-may designate that some - - 


other station assume the duties of the system operator station in its 
place. 


Commands restricted to the system operator station are noted as such in 
the descriptions of commands in section 3. 


At other operator stations, known as Local Operator Stations, the opera- 
tor can manipulate jobs for that station only. The mainframe identifier 
must match the terminal identifier to manipulate jobs or datasets. 
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SYSTEM OPERATION 2 


This section presents the procedures necessary for bringing the Data 
General Eclipse computer and associated peripheral equipment to an 
operational state. Restart and power-off procedures are also included. 


POWER ON PROCEDURE 


Perform the following procedure to apply power.to the Data General Eclipse 
and associated devices. This procedure does not tell how to apply power to 
the CRAY-1. Power-on procedures for the CRAY-1 are given in the CRAY-1 
Maintenance Manual. 


1. Turn on the Eclipse by turning the key on the computer cabinet to ON. 


2. Turn on the disk controller by turning the key in the lower cabinet 
clockwise to the ON or LOCKED ON position. Allow a 30 second 
warm-up period or wait until you hear a loud click indicating that 
the unit is ready. , 
Turn on the Calcomp 114 Disk Drive by pressing the POWER ON button. 
4. Turn on the TEC 455 Data Screen by actuating the switch on the back 
»panel (at upper right as viewed from the back). Select REMOTE at the 
keyboard. 
5. Turn on the TEC 1440 Data Screen by actuating the switch at the lower 
center of the back panel. Select LINE at the keyboard. 
Turn on peripheral devices as required for the computer application. 
7. Perform site-related duties such as turning on the air conditioning. 


PROGRAM INITIALIZATION PROCEDURE 


Initialization of the RDOS system and the station software can be 
performed when the disk ready light comes on after performing the 
power-on procedure. This procedure assumes that the disk pack has been 
initialized with the latest system as described in appendix C.. 
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Figure 2-1. Eclipse console 


1. If necessary, mount the pack containing the desired system. Procedures 
for mounting the disk pack are given in Appendix B. 


2. At the computer console (figure 2-1): 
Set the panel switches “o 100033,. 
Flip up the PR LOAD switch. 
c. The-system is leaded inte the computer memory from the disk. 
When loading is complete, the message FILENAME? appears on the 
1440 data screen. 


3. At the 1440 keyboard: 
a. Press RCTURN, or if a non-standard RDOS system is being used 
reply with sysname and press RETURN. 
b. If the system is being restarted after a system failure, the 
message PARTITION IN USE - TYPE C TO CONTINUE appears. Type C. 
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c. Enter the date and time when prompted by RDOS. If the system 
is being restarted, enter CLEAR/A and press RETURN. Enter 
DIR dir and press RETURN (where dir is the name of the direc- 
tory in use when the failure occurred). Then, enter CLEAR/A 
and press RETURN. 

d. Enter the STATION command and press RETURN to execute the 
command file that causes the on-site or remote version of the 
station to be loaded and begin execution. The station is then 
ready to accept commands entered at the 455 display (section 3). 


RESTART PROCEDURE 


If the system fails (for example, the displays are unresponsive), reinitial- 
ize the system using the following procedure: 


1. To stop and reset the computer, flip the RESET/STOP switch at the 
computer console down and then up. 


2. Set the panel switches to 175400,. 

3. Flip up the Deposit Accumulator 0 switch. 
4. Set the panel switches to 061333,. 

Flip down the PR LOAD/EXEC switch. 

Set the panel switches to 100033,. 

Flip up the PR LOAD switch. 


[ee] ~s [=>] on 
e e . e 


Initialize RDOS and execute the command file that loads the station 
as described under step 3 of PROGRAM INITIALIZATION PROCEDURE 


STATION SHUTDOWN PROCEDURE 


Type END and press RETURN at the 455 display to terminate execution of 
the station program and return the Eclipse to off-line RDOS operation. 
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POWER OFF PROCEDURE 
Use the following procedure to shut down the Eclipse computer system. 


1. At the 1440 display screen, type CTRL and F concurrently to terminate 
the foreground program and type CTRL and A concurrently to terminate 
the background program and return control to CLI. 

2. Type RELEASE DPO and press RETURN. Then wait for the message MASTER 
DEVICE RELEASED before continuing. This Sree releases all SUbgIVECLO RIES 


3. Turn off the disk drive by pressing the POWER ON ‘button: 
4. Turn off displays and peripheral devices. 
; 
CAUTION 


Do not turn off the disk controller before turning 
off the disk drive. Doing so could wipe out the pack. 


POOP OOP OOO LLL DOD LOD DDO LO DDO DDO DODD DOOD OD OD IDOL ODDO DDO D DD ILD DDD LDL OO ILO 


5. When the disk has stopped rotating, turn off the disk controller by 
turning the key in the lower cabinet to the OFF position. 


6. Turn off the Eclipse by turning the key on the computer console to OFF. 


%. Turn off any other equipment special for the site (e.g., the air 


conditioning). 
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CONSOLE COMMANDS 3 


When the station software is running on the Eclipse, the computer is on- 
line to the CRAY-1 as either a remote or on-site station. The TEC Model 455 
Data Screen serves as the operator console for the station and provides 

for communication between the operator and the CRAY-1 CPU. The console 
(figure 3-1) consists of an alphanumeric keyboard and a cathode ray tube 
(CRT) display. The CRAY-1 operating system (COS) uses the display screen 

to bring information to the attention of the operator. The operator 
initiates communication with the CRAY-1 or responds to requests from the 


CRAY-1 by entering commands at the 455 keyboard. 


Figure 3-1. TEC Model 455 Station Console 
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STATION DISPLAY FORMAT 


The station generates a 24-line display image (80 characters per line) on 
the screen (figure 3-2). The first line identifies the version of the 
station, the current date, and the time. The second tine ts used for 
hardware status messages described in appendix E. 


The next 18 lines are used for displaying status information requested by 
the operator. Contents of this area are affected by a number of status 


commands described later in this section. A set of system debug displays 
available only to the system analyst is described in the CRAY-0OS System 
Programmer's Handbook. 


es 


date time 


Display area 


Figure 3-2. Station screen format 
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The fourth line from the bottom of the display is normally unused. 

The three bottom lines of the display are for command entry and response. 
Through the SCROLL command, this area can be expanded to encompass al] but 
the top two lines. As each command is interpreted, it appears on the bottom 
line of the display. Entries are rolled up to the other lines and event- 
ually disappear off the screen as responses and additional commands appear. 
The symbol > appears on the bottom line when the system is ready to process 
the next entry from the keyboard. A colon precedes each command processed 
from an indirect command file. 


INDICATORS 


Sixteen indicators form a vertical column to the right of the display 
screen. The station turns on these indicators under the conditions 
shown in figure 3-3. 


Station logged on 
: Staging on 

Display refresh on 

Automatic print on 

CRAY-1 real-time clock on (meaningful for MCU only) 
: ; unasstgned 

Figure 3-3. Display indicators 
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STATION KEYBOARD 


The console keyboard (figure 3-4) provides coded signals tothe station c 
for transmittal to the CRAY-1 for processing. The operator controls 
statton operation by entering station commands. The use of special i 


keys is summarized in Table 3-1. _ 
i t 


P= 
oy e 
P 


power (1) C) wait 
G5 Loca. C) C) remote 


END OF A CLEAR |] CLEAR 
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y INSERT ro DELETE 
R CHAR CHAR 
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| 
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— ome || —> 
ro 
pa Se 5 | ere 
INSERT DELETE 
LINE Lv LINE 


CLEAR CLEAR 
To TO 
H =6EOL * EOP 


Figure 3-4. Console keyboard 


Table 3-1. Use of special Keys 
| F 


Transmits the command, 


Backspaces and erases one character on the entry | 
Tine. 


(Shift and L keys) Deletes an entire line. 


unction 


RETURN 
RUBOUT 


\ 


eo 


Rolls STATUS or LINK display forward one frame. 
_Rolls STATUS or LINK display backward one frame. 
Discards unprocessed keyboard input. . 


+ or > 


- or < 
CNTRL-A__ 
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COMMAND ENTRY 


Use the following procedure to enter a command at the 455 keyboard. 

1. Type the command. As each character is typed, it is placed in 
a type-ahead buffer. This buffer stores up to 79 characters. 
A bell rings if the type-ahead buffer is full. In this case, 
wait until another command is processed and try again. 
The bell also rings if one of the special keyboard keys (other 
than RETURN, RUBOUT, and CNTRL-A) is pressed. 
To correct a typographical error, press RUBOUT once for each 
character to be deleted and re-entered. 
To delete an entire line, press \, that is, press SHIFT and L 
concurrently. 

2. To terminate a command line (place it in the type-ahead buffer), 
press RETURN (indicated by » in command descriptions). 


When the station is ready to process the next command in the type-ahead 
buffer, it rolls the response/entry lines up and displays the current 
command on the bottom line. 


To purge the type-ahead buffer of all unprocessed keyboard input, press 
‘CNTRL-A, that is, press CNTRL and A simultaneously. After the command in 
process is completed, an : and the message CNTRL-A PAUSE are displayed. 
Control then returns to the console keyboard. 


COMMAND SYNTAX 


Commands described in this section have the following general form: 


verb, Pi sP20+++sP, » 


verb This is a set of characters that uniquely identifies the 

command to the station. The entire command verb need not 
be typed. A minimum of three or enough characters to render the 
verb unique must be entered. These characters are shown under- 
scored in the command descriptions. 
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P; Requirements for parameters vary with each command. Details are 
given with the description of each command later in this section. 
The delimiter between parameters can be either one or more blanks, 


or _a.coma. A parameter having a default value can be omitted. The 


position of an omitted parameter must be indicated by the commas 
that would ordinarily delimit it. 

For some parameters, a short form is allowed. In these cases, 
only the characters shown underscored need be entered to identify 


—e 


it to the station. 


INDIRECT COMMAND FILES 


This section describes how the operator can summon an RDOS file containing 
station commands to be processed. 


To set up an indirect command file, the operator (under RDOS control, 


section 4) creates a file containing station commands. These may be in 
the form of punched cards copied to a mass storage file, for example. 


To summon these commands for processing, the operator enters the command: 
Cfilename® | 

where filename is the name of the RDOS file containing the commands. 

The closing @ is optional. 


The station begins processing commands at the beginning of the file. As 
each command is processed, it appears on the display preceded by a colon. 
When the end of the indirect file is reached, control returns to the 
console keyboard. This is signalled by > on the entry line. 


If an error occurs, processing from the indirect command file halts. 

To resume processing with the next command, ignoring the error, the opera- 
tor types » (i.e., RETURN). Any other entry causes the system to term- 
inate processing of commands from the indirect file and resume processing 
of commands from the keyboard. 
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A command file may itself contain a call to another indirect command 
file. Control passes to the new file and does not return to the file 
that issued the command. 


NOTE 


When the station is activated, the file $STAT.CM is 
executed as an indirect file if it exists. 


A PAUSE command embedded in an indirect command file or a CNTRL-A at the 
keyboard causes processing of commands in the file to halt. The operator 
may then transfer command processing to the console by entering a command 
or may resume processing of commands in the indirect file by sending a 
null line (RETURN only). 


Example of indirect command file contents: 


File Al, summoned by the command @A1@ contains the following commands: 


START 

LOGON DG 
SUBMIT JSYSDIR 
DELAY 20 

LIMIT 1 


TYPES OF STATION COMMANDS 


Station commands described in this publication are of five types: 


MCU commands, 

Batch entry commands, 

Operator commands, 

Display and status response commands, and 


Communication commands. 


These general classes of commands are briefly summarized in the following 
paragraphs, after which each command is described in detail. 


MCU COMMANDS 


When the Data General Eclipse is linked tb the MCU channel of the CRAY-1 
(either on-site or remotely through an on-site Eclipse), the operator can 
issue the commands summarized in table 3-2. 
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Table 3-2. MCU command summary 


STARTUP Begins CRAY-OS operation based on COS source file 
| and parameter file. 


DUMP Dumps a selected portion of CRAY-1 memory to an 


Eclipse file. A STARTUP must follow this command. 


Enables or disables CRAY-1 real time clock 
interrupts. 


INTERRUPT 


PARITY __—__—=_{Enables or disables CRAY-1 parity error scan. 


If STARTUP is issued from a remote Eclipse, the files required for starting 
up the CRAY-1 must be on the on-site Eclipse disk. 


Similarly, if the DUMP command is issued at a remote Eclipse, the informa- 
tion returned will reside on the on-site Eclipse disk. 


The PARITY command enables or disables parity error scan at the on-site 
station or concentrator only. 


BATCH ENTRY COMMANDS 


Entry of batch jobs at the Eclipse station is provided through the 
commands summarized in table 3-3. General functions include station 
activation, staging control, and input/output control. In addition; 
there are a number of specialized commands. 


Station activation commands 


The station activation commands (LOGON and LOGOFF) turn on or turn off 
the communication link between the Eclipse and the CRAY-1. When the 
station is logged on, the operator can issue commands to be processed at 


the CRAY-1 rather than just at the Eclipse. ~~ 


Staging control 


Staging is the process of transferring jobs and data in the form of CRAY-1 
datasets from the Eclipse disk to CRAY-1 mass storage or of transferring 
datasets from CRAY-1 mass storage to the Eclipse disk. When the Eclipse 
station is logged on-and entries are present in either the station input 
staging queue or the CRAY-1 output staging queue, staging of datasets 
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Table 3-3. Batch entry command summary 


Station activation 
LOGON Establishes communications between the station 
and the CRAY-1. , 


LOGOFF Terminates communications between the station 
and the CRAY-1 ‘ 


Staging control 


STAGE Suspends or resumes staging of datasets between 
the CRAY-1 and the Eclipse. 


QUEUE Enters an Eclipse-resident file into the staging 
input queue for the CRAY-1. 


SUBMIT Queues a job dataset for staging to the CRAY-1. 


SAVE Queues a permanent dataset for staging to the 
CRAY-1. 


Input/output control 
BLOCK’ Formats a dataset into CRAY-1 blocked format and 
queues the dataset for staging to the CRAY-1. 


PRINT* Enables or disables automatic printing of queued 
output datasets. 


Miscellaneous control 
* SNAP Copies screen contents to a file or the printer. 


PAUSE Suspends indirect command file processing and 
allows operator to abort it or resume it. 


END Terminates station and returns control to RDOS. 


DELAY Suspends processing of a command for a specified 
time interval. 


POLL Sets the rate at which control messages are 
exchanged with the CRAY-1. 


SET . Modifies the default value associated with a 
parameter. 


a Deferred implementation 
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automatically begins. The operator can suspend staging through the STAGE 
OFF command and can subsequently resume staging through the STAGE ON 
command. 


Names of files to be staged to the CRAY-1 are contained in the input queue 
file DPO:$STAT.IQ. Each file created via the BLOCK command is assigned a 
filename with the format $STATnnmn.IF, where nnn=000 through 240. When a 

file has been staged to the CRAY-1, it is deleted unless if was queued by 
the QUEUE, SUBMIT, or SAVE command 


The output queue file, DP@:$STAT.0Q, contains names of files to be printed. 
Each file is assigned a filename with the format $STATnnn.OF, where nnn= 
000 through 240. After’ being printed, the file is deleted. 


To delete $STAT.1Q or $STAT.0Q, the operator can use the RDOS DELETE 
command. This will clear the files from the input or output queue. 

The operator may explicitly enter an existing file into the staging 
queue through the SAVE, QUEUE, or SUBMIT commands. Such a file must be 
already in CRAY-1 blocked format, possibly having been processed by the 
BLOCK program as an RDOS off-line function. 


The normal method for entries to be made in the input staging queue, how- 


ever, is through the BLOCK command, as described under Input/output control. 


The CRAY-1 maintains the queue of datasets to be staged out to the Eclipse. 
The operating system makes an entry in this queue for the list output data- 
set for each job and for any permanent dataset routed to the Eclipse to be 
saved on the Eclipse disk. Datasets with the disposition code PR (print) 
are entered into the print queue. If the disposition code is not PR, the 
dataset is entered into an Eclipse file. 


Input/output control 


Through the BLOCK command, the operator can make entries in the input 
staging queue. The jobs entered are blocked into the CRAY-1 dataset 
format as determined by the station input directives (section 5) accom- 
panying data in the deck. Directives also describe whether the dataset 


is a job input datasét or a staged permanent dataset. The resulting 
dataset is entered into the input staging queue at the Eclipse. 
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Table 3-3. Batch entry command summary 


Station activation 


LOGON Establishes communications between the station 
and the CRAY-1. , 


LOGOFF Terminates communications between the station 
and the CRAY-1 ; 


Staging control 


STAGE Suspends or resumes staging of datasets between 
the CRAY-1 and the Eclipse. 


QUEUE Enters an Eclipse-resident file into the staging 
input queue for the CRAY-1. 


SUBMIT Queues a job dataset for staging to the CRAY-1. 


SAVE Queues a permanent dataset for staging to the 
CRAY-1. 


4 Input/output control 


BLOCK’ Formats a dataset into CRAY-1 blocked format and 
queues the dataset for staging to the GRAY-1. 


PRINT* Enables or disables automatic printing of queued 
output datasets. 


Miscellaneous control 
* SNAP Copies screen contents to a file or the printer. 


PAUSE ; Suspends indirect command file processing and 
allows operator to abort it or resume it. 


END Terminates station and returns control to RDOS. 


DELAY Suspends processing of a command for a specified 
time interval. 


POLL Sets the rate at which control messages are 
exchanged with the CRAY-1. 


SET . Modifies the default value associated with a 
parameter. 


, Deferred implementation 
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automatically begins. The operator can suspend staging through the STAGE 
OFF command and can subsequently resume staging through the STAGE ON 
command. 


Names of files to be staged to the CRAY-1 are contained in the input queue 
file DPQ:$STAT.IQ. Each file created via the BLOCK command is assigned a 
filename with the format $STATnnn.IF, where mmm=000 through 240. When a 
file has been staged to the CRAY-1, it is deleted unless if was queued by 
the QUEUE, SUBMIT, or SAVE command 


The output queue file, DP@:$STAT.0Q, contains names of files to be printed. 
Each file is assigned a filename with the format $STATnumn.0F, where nnn= 
000 through 240. After being printed, the file is deleted. 


To delete $STAT.IQ or $STAT.0Q, the operator can use the RDOS DELETE 
command. This will clear the files from the input or output queue. 


The operator may explicitly enter an existing file into the staging 
queue through the SAVE, QUEUE, or SUBMIT commands. Such a file must be 
already in CRAY-1 blocked format, possibly having been processed by the 
BLOCK program as an RDOS off-line function. 


The normal method for entries to be made in the input staging queue, how- 


ever, is through the BLOCK command, as described under Input/output control. 


The CRAY-1 maintains the queue of datasets to be staged out to the Eclipse. 
The operating system makes an entry in this queue for the list output data- 
set for each job and for any permanent dataset routed to the Eclipse to be 
saved on the Eclipse disk. Datasets with the disposition code PR (print) 
are entered into the print queue. If the disposition code is not PR, the 
dataset is entered into an Eclipse file. 


Input/output control 

Through the BLOCK command, the operator can make entries in the input 
staging queue. The jobs entered are blocked into the CRAY-1 dataset 
format as determined by the station input directives (section 5) accom- 


panying data in the deck. Directives also describe whether the dataset 
is a job input datasét or a staged permanent dataset. The resulting 
dataset is entered into the input staging queue at the Eclipse. 
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As an alternative to using the BLOCK command, the operator may take a job 
deck or a data deck that has been arranged according to the requirements 
of the BLOCK program (section 4) and as an off-line RDOS operation, exe- 
cute the BLOCK program. This program blocks the input into CRAY-1 data- 
set format but does not make an entry in the input staging queue. The 
operator must issue a SAVE, QUEUE, or SUBMIT command to cause the dataset 
to be staged. 


The operator can initiate automatic operation of the printer/plotter 
through the PRINT command. This means that all datasets staged to the 
Eclipse that have a disposition code of PR (print) are automatically 
printed. Automatic operation of the printer/plotter can be suspended 
through the PRINT,OFF command and resumed through the PRINT,ON command. 
The station need not be logged on for this automatic printer/plotter 
operation to occur. When execution of the Eclipse station begins, auto- 
matic operation of the printer/plotter is not in effect. 


As an alternative to automatic operation of the printer, the operator 
may, aS an off-line RDOS operation, print files on the Eclipse disk 
using the OUT program (section 4). The OUT program deblocks and prints 
one file at a time. 


Miscellaneous control 


The operator is able to record screen contents through the SNAP command. 
This is useful for providing hard documentation of a problem. For 
example, the operator may elect to SNAP a status display. 


The PAUSE command may be embedded in an indirect command file. When it 
is encountered, control switches to the keyboard where the operator may 
either terminate indirect processing or cause it to resume. 


Processing of the next command entered by the operator or from the com- 
mand file in which it may be embedded can be delayed through the DELAY 
command. For example, a DELAY command issued between STATUS and STORAGE 
commands would allow the STATUS display to be viewed for a period of 
time before the STORAGE display is initiated. Similarly, issuing 
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a DELAY 60 command between STARTUP and LOGON would cause the CRAY-1 to 
run one minute before the LOGON takes effect. 


The END command terminates execution of the station and returns control 
to RDOS for off-line operation of the Eclipse. Step 3d of Program Ini- 
tialization (section 2) must be followed to re-initialize the station. 


If no staging is in progress, the POLL command determines the rate at 
which messages are exchanged with the CRAY-1. 


The SET command is used to modify the default value associated with a 
parameter. 


OPERATOR STATION COMMANDS 


The operator station commands, summarized in table 3-4, provide for 
controlling jobs, mass storage, the link, and channels. 


Job control 


A job is the unit of work described for the CRAY-OS Operating System. A 
job enters the system via a station (perhaps as a card deck)’ and is staged 
to the CRAY-1 as a job input dataset and is scheduled for processing. A 
job input dataset begins with a set of control statements defining the 
chgracteristics of the job and specific steps the operating system is to ~ 
take while processing the job. Section 5 describes station requirements 
for a job input dataset. Job control statements are described in detail 

in the CRAY-0S Version 1.0 Reference Manual, CRI pub. no. 2240011. However, 
it is important for the operator to know that the first control statement 
is a JOB statement that provides the name of the job and possibly the 
CRAY.1_processing -time. limit_and_memory field size. Accompanying the 
control statements for the job may be one or more files of data such as 
source language decks and data to be processed. These or other types. of 
data needed by a job may alternatively reside permanently on CRAY-1 mass 
storage rather than accompanying the job or may be staged from the Eclipse 
to the CRAY-1 independent of the job. 
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Table 3-4. Operator station command summary 


Command Function 


Job control 


LIMIT Sets maximum number of jobs that CRAY-1 can 
process at one time. 


DROP’ Ends processing of job at CRAY-1 immediately 
but does not delete output datasets. 


KILL Ends processing of job at CRAY-1 immediately 
and/or deletes output datasets. 


RERUN Ends processing of job: at CRAY-1 immediately 
and attempts to rerun the job. 


SUSPEND - Suspends processing of a job. 
RESUME Resumes processing of a suspended job. 


ENTER Assigns a new time limit or priority to a job 
(or its output dataset) or changes the ID for 
the station at which the job originated or to 
which its output dataset is to be sent. 


MESSAGE Enters message into a job logfile, the system 
logfile or both. 


SWITCH’ Sets or alters a job sense switch. 


Link control 


ROUTE Changes the station ID for all jobs and output 
datasets having a specific ID to a new ID. 


OPERATOR Changes the ID of the operator station. 


STREAM Changes the input, output, and active stream 
counts for the specified station. 


DISCONNECT® Logs off the specified front-end if it is 
logged on. 


, 


Channel control 
CHANNEL Turns CRAY-1 channel on or off. 


Mass storage control 
DEVICE* 


Sets or clears read-only mode for CRAY-1 mass 
storage device. 


T Deferred implementation 
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Control of jobs includes: 
- Setting the maximum number of jobs that can be multiprogrammed (LIMIT), 


- Terminating (KILL or DROP), suspending (SUSPEND), rerunning (RERUN), 
or resuming (RESUME) processing of specific jobs, 


- Altering the characteristics of a job (ENTER) such as its time 
limit, priority, and job identifier, 


- Setting or clearing job sense switches (SWITCH), and 


- Entering messages into the job logfile, the system logfile, or 
both (MESSAGE). 


When using job control commands, the operator identifies a job by its Job 
Sequence Number (JSQ). Job sequence numbers are shown in the job queue 
status display available through use of the STATUS display command. 


Link control 


Link control commands, ROUTE, OPERATOR, and DISCONNECT, allow system 
operator control of links for other front-end systems as well as of 
its own link. 


Through the ROUTE command, the operator can reroute datasets intended 
for disposition at one station to another station. 


The operator can control the identity of the operator station, itself, 
through the OPERATOR command. 


Any front-end that has been logged-on can be logged-off by the operator 
through the DISCONNECT command. 


The STREAM command is available to the system and local operator sta- 
tions. The operator can change the activity on the link by changing 

_ .the-total number_of_input streams and output streams defined for a link 
and by changing the number of streams that can be active at one time. 
Here, the term "stream" refers to the flow of the pieces of information 
comprising a dataset being staged. When a station is installed (Refer 
to the CRAY-0S System Programmer's Handbook), the number of input streams 
and output streams is defined for the station. The link control commands 
allow the operator to change this number but not go above it at any time. 
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The input stream count defines the maximum number of datasets that can be 
staged in at any one time. The output stream count defines the maximum 
number of datasets that can be staged out at any one time. The active 
stream count defines the maximum number of datasets that can be handled 

at one time on the link and includes both directions of data flow. Thus, 
for example, if two input streams, one output stream, and three active 
streams are defined, staging in occurs with two datasets interleaved and 
staging out occurs one dataset at a time. However, if three input streams, 
two output streams, and three active streams are defined, the station can 
stage a maximum of three datasets at a time. This may be three input 
streams with no output stream, two input streams and one output stream, or 
one or no input stream and two outout streams. Link control status 
information is available through the LINK command. 


Channel control 


CRAY-1 channels connected to mass storage devices and to front-end systems 
can be enabled and disabled through the CHANNEL command. Channels are 
defined as pairs (one input channel and one output channel) numbered from 
1 to 12 (decimal). The operator should consult a system analyst for 
specific channel assignments. . 


Mas$ storage contro] 


Mass storage devices at the CRAY-1 come under system operator station con- 
trol and can be enabled or disabled through the DEVICE command. Consult a 
system analyst for specific information concerning device identifiers. 


DISPLAY AND STATUS RESPONSE COMMANDS 


The commands summarized in table 3-5 return to the operator status inform- 
ation about jobs, datasets, and the link. Information to be displayed on 
the screen is updated at a rate determined by the REFRESH command. 
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Table 3-5. Display and status response command summary 


[comand | Function 


CLEAR 
COMMENT 
SCROLL 


Clears display area of screen. 
Inserts comment in command stream. 


Causes entire display area to be used as 
command/response area. 


Sets—display refresh rate. 
Displays status of a specific job. 


Displays status of all jobs in job input queue 
- and all datasets in output staging queue. 


Responds with status of specific dataset. 


REFRESH 
JOB 
STATUS 


DATASET 
LINK 
STATION 


STORAGE 


Displays status of station link. 


Displays status of station. 
Displays status of mass storage devices. 


A SCROLL command is provided so that the operator can monitor the command 
entries and responses on all but the top two lines and the bottom three 
lines of the display screen. This display mode is the default when the 
station is initialized. The CLEAR command allows the entire display area 
to be cleared. 


COMMENT does nothing but copy the command to the display area. It allows 
the operator to insert documentation in the command stream. This is 
useful for documenting an indirect file or the SNAP of a display. 


COMMUNICATION COMMANDS 


Communication commands are applicable only when an Eclipse is serving as 
a concentrator or a remote station. Table 3-6 summarizes the commands 
available. 


The LINE command enables or disables a communications link. To enable 
communication between the concentrator and a remote station, the link 
must be activated via a LINE ON command at the concentrator. The link 
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at the remote station may be activated explicitly by the LINE ON command 
or implicitly by the DELETE, DUMP, INTERRUPT, LOGON, RECEIVE, STARTUP, 
and TRANSMIT commands. 


Table 3-6. Communication command summary 


LINE Turn remote link for specific station on or off. 
TRANSMIT * 
RECEIVE’ 

DELETE 


Send file to concentrator. 
Receive file from concentrator. 


Delete a file from the concentrator disk. 


TRANSMIT and RECEIVE are entered at a remote station. TRANSMIT sends a 
file from the remote station to the concentrator. Conversely, RECEIVE 
transfers a file from the concentrator to the remote station. 


NOTE 


Except for file length, the characteristics of the source 
file (the file type and file attributes) are not conveyed 
to the destination file. The destination file is created 
as a random file and no attributes are assigned to the 
file 
To retain the file type (e.g. contiguous) or file attri- 
butes (e.g. save file): 

1. Use the DUMP utility to create an intermediate file 

from the source file, 


2. Transfer the intermediate file to the concentrator 
or remote station, and 


3. Use the LOAD utility to create the destination 
file. 


The intermediate file created by the DUMP can contain more 
than one source file. 


For example, to send FILE] and FILE2 to the concentrator 
retaining their file characteristics, the following se- 
quence of commands could be used. 


z Deferred implimentation 
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Under RDOS at the remote station, create the in- 
termediate file IFILE: 


DUMP/V [FILE FILE1 FILE2 


Use the remote station to send the file to the 
concentrator: 


TRANSMIT IFILE 


Under RDOS at the concentrator, create the des- 
tination files: 


LOAD/V/R IFILE 


This creates files FILE1 and FILE2 whose characteristics 
are the same as those of the source files at the remote 
station. 


DELETE is entered at a remote station only. The DELETE command deletes 
a file from the concentrator disk. 


COMMAND DESCRIPTIONS 


The remainder of this section contains a detailed description of each 
command. Command descriptions are in alphabetical order according to 


verb. 


+ 


COMMAND FORMATS 


UPPER CASE 


Identifies the command verb or literal parameter. 


UNDERLINED UPPER Specifies the minimum number of characters required 


CASE 


Ttattes: 


[ ] Brackets 


{} Braces 


Py Arrow 
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for the verb or parameter to be recognized. 


Define generic terms which represent—the-words or 
symbols to be supplied by the user. 


Enclose optional portions of a command format. 


Enclose two or more literal parameters when only 
one of the parameters must be used. 


Indicates the RETURN key. 
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initially set to 100. 
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KILL = KILL JOB 


‘FUNCT ON: Deperiding -on the status of the job, either deletes its 
“input dataset from the input “queue. if? process ihg- has. not. 
yet begun, terminates. processing Lf procéssing ‘has ‘begutr,, 
or deletes the job's output datasét froin. the: : <output queue. 
if processing: has- compléted. KILL (unTike DROP) does, not 
cause processing: of EXIT contro] statements that may be. 
tithe job" deck. 


FORMAT: KLE, jeg) 
jsq Job. Sequerice” ‘number’ -by- which Job: or its output. 


dataset: is: identified. The’ JSQ for the Job, 
can be obtained through the STATUS: command. 
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; -LENE. - ACTIVATE OR DEAGT-IVATE REMOTE ‘STATION LINK 5 

; FUNCTION: Activates or deactivates Jink ‘to remote: station. Note that, 

: * the LINE -ON-funetion- -at:-the-remote--station: is—imp Hi: tf 

the communications commands, as wel} ‘aS the’ DUMP, INTERRUPT 

: LOGON. and. STARTUP “commands : 

: FORMAT=: t 

i ON Turns .on Vink i 

OFF Turns off lirik | 

i vumbex- Number of Tite to activate or -dedctivate. Consult | 

i system. analyst for the communication, conFiguratio On. : 

[ If muniber. 18 not specified; 1 is used. 7 
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- Station wp: Yeas “4 


- ‘Quéue “toiint, that: ‘iss the umber of datasets 


at ‘CRAY-1 to: be Staged to the “E61; tpse.g 
~ ‘Number of ‘active input! ‘streams. 
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ia Number: of”, active’ output streams. 23 


_ Maximum, numbér" ‘of input streams at LOGON. 


* = Maximum umber of output streams at LOGON. ; 


- Maximuin number :of actiyé streams, at” LOGON. 
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LOGOFF - LOG OFF STATION 
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FUNCT1ON#: Terminates communications betweén. the station and the CRAY-1. 


“Seer ees Se ee oe a 


TYPE: ‘Batch entry; station activation subtype. 
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MESSAGE - ENTER MESSAGE: INTO. LOGFILE 


"FUNCT.4ON:: Enter a message ‘into a job logfite,, the system logfite,, 
: or both “ 
ae 7 
' : JOB: jobriame 2J 8. 
FORMAT::. MESSAGE, BOTH, jobname g8q | smessage 
f 7 7 SYSTEM ee. 
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: BOTH Enter message into the’ job- logfile and -the 
r ‘system logfile 


SYSTEM. Enter message into the system logfile 
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‘ fiest..of whack. must, be:salphabetic, {A-Z), Y: 


Sq JOb- ssequenéé -numbex by. which. the gob is 
identified. ‘The,-JSQ for the job can be 
obtained through the STATUS ‘display: 


message Character string. to.-be-entered: into the 
logfile: The: message will be truncated to 
79. characters iF necessary’. 


TYPE: Operator stations job control subtype 


PREREQUISITES: Eclipse i$ operator station: and is Togged on.. 
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. “Changes operator Station: from: etrrently deS ignated station: 
. (at which this coimaind is entered) to. some..other front-efid 
‘system.* Thé newly. designated eperator.. station jis ‘Fdentified 
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PARITY - MONITOR: CRAY-1 PARITY: ERRORS 


FUNCT LON: Enables or disables CRAY- 1 ‘parity error ‘scan, Parity 

‘error information is displayed on the “second lite of 
the: display screens ‘See- appendix: £ for the. display 
format and field descriptions. When parity error 
scanning qs enabted,. the. station tests for errors at 
‘ene -or two sécond intervals: If CRAY- ‘1 parity errors 

_ are. occufring more fréquently,. the gtation will. detect, 
only a sampling of. the-‘errors. 


FORMAT: PARITY 5 


FERSE Fnables. parity’ seryror monitoring. | Monitoring 
‘terminates after - the First CRAY=1 paritty-error 
is. detected. fe 
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SCAN Enables parity error moni toring. Pari! ty -error 
monitoring does tiot terminate when a parity 
error ‘TS ° detected, The parity: error display. 
is updated, tq contain information | on the ‘most 
recent, error. 


“OFF Disables parity error monitoring. 
TYPE< MCU 


“PREREQUISITES: On-site station: or concentrator: only 
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PAUSE - INDIRECT COMMAND FILE PAUSE 


FUNCTION: Suspends interpretation. of commands, from indirect file ‘and 
allows ‘operator to terminaté processing “from ‘the indirect, 
file (by entering .a command) ° or to. resume processing firdm. 
the indirect file by entering- a nuit: command (RETURN only). 


FORMAT’: ~ PAUSE’ 


TYPE: Batch entrys miscel lahéous subtype 
PREREQUISITES: ‘None 
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FUNCTION: Sets rate at which CONTROL messages. .aré exchanged with 
the CRAY-1: 
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QUEUE ~ QUEUE INPUT DATASETS 
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‘FORMAT: 


TYPES; 


Enters named Eclipse file into staging queue to be sent, to 
CRAY-1 as. job dataset or permanént dataset. 
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« FUNCTION: Sets the. interval betwéén display refreshes’. 
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RESUME. - RESUME JOB PROCESSING 
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“FUNCT FON? Resichedules a: suspended’ job for: processing. The: job may 
have been suspended by a SUSPEND command. 
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jsq -Job: 'Sequerice fumber by whi ch the: job: is: 
identified. The’ JSQ ordinal for a job can, ° 
be ascertained through the STATUS: command. 
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SAVE - -QUEUE- PERMANENT -DATASET 


é ‘FUNCT ON: Queues on the Eclipse file ‘for staging. to the CRAY-1. 
At the CRAY- -1, the file will be made a permanent. dataset.: 


FORMAT : SAVE , filename bs dataset] (pare) > 
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filename’ Name of the file to. be staged: The, file must be, 
& random or coriti:guous filé. See the BLOCK pro- 
gram description: to create ‘the file. 
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TYPEY Batch entry; staging control subtype 


‘PREREQUISITES: None: 


ome — — nn” Oe ha: ae ae ee ee: ee _ is 
a y ; ‘a ss é x a ae 
sled 


I 224d006 3-83 


gk Air ten ate ci 


* Féenoe sed La Mae a gee pore ae a a eS * amet hee Aa hob 


oe 


* ed wep re + ver 


Screen. 
command.. 


FORMAT: SCROLL, ) 


PREREQUISITES: None 
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SCROLL - USE ‘DISPLAY FOR GOMMAND/RESPONSE SCROLL AREA 


“FUNCT FON: Changes, the. entire display area (except for the two-line 
header) to a command/ response area. Commands .and 
responses are’ rolled ‘up: ‘to the. second line of. the: display 
in a scroll- like fashion: ‘before disappéaring fiom the — 

This mode ts in effect: when: the: station: begi ins 

execution. and 1s: cleared by issuing -any. other display 


TYPE: Display. ‘and, status response 
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STREAM - CHANGE: STREAM. CQUNTS 


FUNCT ION: 


FORMAT: 


TYPE: 


PREREQUISITES: 


EXAMPLE: 


! 
| 
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Changes ‘input, output, and active stream parameters for 
the. station with the speci fied id. Thesé parameters are 
initially defined for a station as assembly. options and 
take effect: ‘when -a’ station: logs ‘en. STREAM. commands’ 
cannot increase stream counts beyond. ‘the Togen. Limits... 


STREAM wd ,ni,no,na ; 


td Station, id for which. other parametérs apply 
nt Number. of ‘input streams allowed, 0-8 

no, Number of ‘output strearis allowed. 0-8 
na Number of streams on which data can be sent 


concurrently, that 7's » aétive ‘streanis; 0-16 
Operator: stations Tink control. ‘subtype: 
Eclipse is opéwator station. and 4s. lagged on. 
STREAM,DG ,1,1.1 P 
Designates. -that. station. DG can. have: only. one. input. Streant: 


and one output Stream and that. both. cannot ‘be active at. the 
Same time... 
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SUBMIT = QUEUE JOB. DATASET 


Ae 


FUNCT ION: Queues an Eclipse filé for staging to the CRAY-i. At. 
the CRAY-I, the dataset will be entered into. thé. Job, 
input: queue. 

FORMAT, SUBMI qi ft Lename 
filename Name of file ‘to be stagéd, The file must, be aa 
: random -or. conti: guous file. _ Sée BLOEK program 

description to create the file. 

TYPES Batch entry; Staging control subtype’ 


PREREQUI'SITES:. ‘None 
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SUSPEND: - SUSPEND JOB PROCESSING oe, 
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FUNCT ION: Suspends processing of job identified by its SDT entry.. 


oe 


FORMAT: SUSPEND ,Jsq y . ry 


J8g Job, sequence number by which job to be 
: suspended is. idéntified., The. JSQ.can be j 
ascertained from the STATUS: -display:. I 


TYPE: Operator’ station: job contro] subtype, 


PREREQUISITES: Eclipsé is a. system operator station: and ‘is logged on 
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TRANSMIT = “TRANSMIT FILE TO CONCENTRATOR’ 


FUNCT | ON: 


FORMAT : 


PEs 


PREREQUI'S LTES? 


Sends. specified file from a remote station to the 


concentrator. See section 3 for restrictions. 


TRANSMIT svfité E;eftte] 


xpi tbe. Name of file at’ the remote station to be :sént. 


to the concentrator. 


efile Nate £0. be dssignéd to the file at the ‘cofi- 
centrator. If not spécified, rfile- 


Communicate ons. 


Remote station only 
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CLI OPERATION 4 


INTRODUCTION 


This section briefly describes the features of the RDOS Command Line 
Interpreter. For a complete description, refer to the Data General 
publication 093-000109, RDOS Command Line Interpreter Reference Manual. 


The Command Line Interpreter (CLI) is the interface between -the console 
operator and the RDOS operating system. The operator enters CLI commands 
via the 1440 keyboard (figure 4-1). CLI passes the commands to RDOS for 
processing and displays messages and requests for entry on the 1440 display. 


COMMAND SYNTAX 


Each command consists of a verb and parameters. 


verb PoP o0++sPn 


verb The verb is a group of characters representing a unique CLI 
command or the name of a file to be executed by RDOS. The 
verb may be accompanied by one or more switches. 


verb/s /s./.../8 
1 2 n 


Py Indicates a string of arguments. Each argument may be 
accompanied by one or more switches. 


p,/e /s /-++/8, 


Arguments and switches vary with each command and are described in this 
manual only for.those commands added to the repertoire by Cray Research. 
For details of Data General CLI commands, refer to the CLI Reference Manual. 


DISPLAY FORMAT 


The most recent message or command is displayed on the bottom line of the 
CRT. As new information is added at the bottom, older information is 
pushed up in a scroll-like fashion and eventually disappears from the top 
of the screen. The Data Screen is illustrated in figure 4-2. 
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Figure 4-1. TEC 1440 Keyboard 


‘Figure 4-2. TEC 1440 Data Screen 
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HOW TO ENTER A COMMAND 
Use the following procedure to enter a CLI command at the 1440 keyboard. 


1. Type the command beginning with the first character position of the 
entry line. As each character is typed, it appears on the bottom line 
of the display. The cursor advances so that it always marks the 
position of the next character to be typed. 


2. Press RETURN (indicated by } in command descriptions) to transmit 
the command to CLI. All information up to the cursor is sent. When 
the command has been processed by RDOS and CLI is ready for the next 
command, a simple or time-augmented prompting reply appears on the 
line following the command entry. If the command cannot be processed, 
an error message appears before the reply. 


Correct any typographical error before transmitting a command by pressing 
RUBOUT once for each character to be ignored. The cursor advances one 
character each time RUBOUT is pressed. The display is not updated to 
reflect the deleted characters. 


Type \ (SHIFT and L keys) to delete an entire line. 


Multiple commands can be entered on a single line when a command is 
terminated a semicolon rather than pressing RETURN. To send the entire 
line, press RETURN. 

+ 


A command or command series can be continued on additional lines by enter- 
ing 4 (SHIFT and N keys) immediately before pressing RETURN. This causes 
the RETURN to be ignored as the command terminator and causes the informa- 
tion on the next line to be considered as. a continuation of the previous 
line. 


Typing a period and pressing RETURN causes the current type of ready 
message to be changed from simple to time-augmented or vice versa. 
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ERROR MESSAGES 

Transmitting a command containing an error causes an appropriate error 
message to be displayed. In general, error messages are quite explicit. 
giving the user sufficient information to correct the error easily. For 
details, refer to the RDOS Command Line Interpreter Reference Manual. 


SPECIAL KEY ASSIGNMENTS 


Table 4-1 summarizes special uses of keys by the CLI in the command syntax. 


ALTERNATE COMMAND INPUT 

To temporarily discontinue command entry at the display/keyboard and to 
cause CLI to read commands from an alternate (indirect) source, enter 
@filename@ where filename is the file or device containing the command 
images. 


Table 4-1. Special key assignments for CLI 


Key Function 


RETURN Terminates a command activates CLI. 
\ (SHIFT and L keys). Deletes an entire line. 


RUBOUT Causes the last character in the string to be ignored 
and advances the cursor one space. 


! ; 
» or Space Separates arguments in a command. Extra spaces are 
be ignored. 


; Delimits multiple commands on a command line. 


A (SHIFT and N keys). Causes the next RETURN to be 
ignored so that information on the next line continues 
the entry. 


- RETURN Changes the reply format from simple to time-augmented 
or vice versa. 


@---@ Causes CLI to interpret commands or command fragments 
from the file or device named within the pair of @'s. 
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SYSTEM CONSOLE BREAKS 


The console break mechanism provides a means of terminating the program 
executing in the foreground or in the background. 


CTRL and A Terminates background program; CLI is reactivated. 


CTRL and F- Terminates foreground program. 


FILE NAMES 


All RDOS devices and disk files are accessible by file name; magnetic 
tape files are accessible by file number. A file name is a byte string 
of up to ten ASCII characters. Characters in a file name can be upper 
case alphabetic, lower case alphabetic, numeric, and $. A carriage 
return, null, space, or line feed terminates the file name. 


An extension consisting of a string of alphanumeric characters and $ 
characters may be appended to a file name. If more than two characters 
are provided, only the first two are used. 


END OF FILE 


When using the card reader as an input device, RDOS detects end of file 
when all rows are punched in column 1 of the card. An end-of-file card 
can be punched on a 029 keypunch by multipunching the following characters: 
&, - 2 and 0 through 9. 


When using the 1440 console ($TTI) as an input device, CTRL and Z acts as 
an end of file. 


RESERVED DEVICE NAMES 


The following list indicates the names of devices reserved by RDOS for use 
in CLI commands when addressing a device. Using any of these names in a 
command that creates a file would result in a duplicate file name. 
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Device name 


Device 


= —_ 


$€DR Punched card reader ; 
$CDR1 Second punched card reader } 
CIn Cassette unit x, first controller . 
CTln Cassette unit n, second controller | 
DKO Fixed head Novadisc, first controller 
DK1 Fixed head Novadisc, second controller iy 
$DPI Input dual processor link i 
$DPO Output dual processor link 
$LPT 80 or 132-column line printer | 
$LPT1 Second line printer 
MCAR Multiprocessor communications adapter receiver | 
MCAR1 Second multiprocessor communications adapter 
receiver ; 
MCAT Multiprocessor communications adapter transmitter | 
MCAT1 Second multiprocessor communications adapter : 
transmitter | 
MIn 7- or 9-track magnetic tape transport n, first 
controller (n > 0) 
MT1n 7- or 9-track magnetic tape transport x, second i 
controller (x > 0) 
$PLT Incremental plotter | 
$PLT1 Second incremental plotter 
* $PTP Paper tape punch 
$PTP1 Second paper tape punch | 
$PTR Paper tape reader 
$PTR1 Second paper tape reader | 
$QTY Asynchronous data communications multiplexer 
$TTI 1440 display keyboard | 
$TTI1 455 display keyboard 
$TTO 1440 display screen | 
$TTO1 455 display screen 
$TTP Teletype punch J 
$TTP1 Second teletype punch 
$TTR Teletype reader : 
$TTR1 ‘ Second teletype reader | 
2240006 4-6 5 
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CLI COMMAND DESCRIPTIONS 


This section contains descriptions of commands added to the CLI repertoire 
by Cray Research. All other CLI commands are described in the Data General 
Command Line Interpreter Reference Manual. 


The station operator may wish to refer to that publication for descriptions 
of the following commands which are likely to be used when operating the 
Data General Eclipse. 


CLEAR Clear file use counts 

DELETE Delete files 

DUMP Dump one or more files 

ENDLOG Close the log file 

EXFG Execute in foreground 

FILCOM Compare two files 

GTOD Get date and time 

INIT Initialize directory or device 

LIST List directory 

LOAD Reload dumped files 

LOG Open the log file 

PRINT Print a file 

RELEASE Release a device 

RENAME Change the file name 

SDAY Set today's date 

STOD Set time of day 

TYPE Display file contents 

XFER Perform file-to-file copy 
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NAME: 


FORMAT : 


BLOCK (Block CRAY-1 datasets) 


BLOCK Cdirfile] [list/L] 


dirfile The Eclipse file from which BLOCK reads directives. 
If the parameter is omitted, the default is the 
card reader ($CDR). Other sources of directives 
could be the 1440 console ($TTI), magnetic tape 
(MT@), or a disk file. 


PURPOSE: 


SWITCHES: 
Global: 


Local: 


DIRECTIVES: 


2240006 


To create one or more Eclipse files in CRAY-1 blocked dataset 
format. Files in blocked format may be queued for staging to 
the CRAY-1 using the SAVE, QUEUE, or SUBMIT station commands. 


/P - Listing goes to line printer. 


/L - List output is directed to given file (overrides 
global /P). 


Directives control the functions performed by the BLOCK 
program. A directive must begin in column 1. Parameters 
are separated by one to three blanks. Comments may follow 


the directive on a card. Directives are displayed as processed. 


/OUT fzlename 


The /OUT directive specifies that the Eclipse file produced 
by BLOCK is to be named fzZename. Subsequent directives up 
to the next /OUT directive or to the end of the directives 
file determine the contents of ftZename. The current /OQUT 
directive pads the prior file (if there is one) to a 512- 
word boundary writes an end of data on the file, and closes 
it. 


sourceftlename [B_] 


This directive causes the RDOS file sourcefilename to be 
added to the blocked dataset with a terminating CRAY-1 end- 
of-file RCW. If no parameter other than the file name 
appears on the directive, the file is processed as a coded 
file. That is, the file is read one line at a time and 
each line becomes a record with all blanks compressed. If 
a second parameter (i.e., B) appears on the directive, the 
file is processed as a binary file. That is, the file 
becomes a single record and there is no blank compression. 


if input is from the card reader, sourcefilename is $CDR. 
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EXAMPLES : 
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/ EOF 


This directive causes the BLOCK program to generate 

a CRAY-1 end-of-file RCW. An unblocked file containing 
/EOF directives can be edited, perhaps changing the 
positions of the file marks. The result can then be 
reblocked with BLOCK. 


If the last record in a file is a /EOF record, BLOCK 


writes just one end-of-file record control word rather 


than two. 


In this example, directives are read from the card 
reader ($CDR). Directives dictate that the coded file 
CFILE on the Eclipse disk is to be written in CRAY-1 
blocked format to an Eclipse file named BLKFILE. 
The command that invokes the BLOCK program is: 

BLOCK 
The directives are: 

/OUT BLKFILE 

CFILE 

(RDOS end-of-file card) 


The following command causes directives to be read 
from an Eclipse disk file named DFILE and causes 
directives to be displayed as they are processed: 


BLOCK DFILE 


The following command causes directives to be read 
from an Eclipse file named DFILE and causes the 
list output to be written on a file named LFILE: 


BLOCK DFILE LFILE/L 
The following command causes directives to be read 
from the console ($TTI) with list output printed: 
BLOCK/P $TTI 


If the operator types the following directives, the 
BLOCK program reads two coded files of punched cards 
from the card reader and creates a CRAY-1 blocked file 
named CFILE. 


/OUT CFILE 
$CDR 
$CDR 

_ (CTRL and Z) 
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The following command causes directives to be read 
from the card reader and the list output to be 
written on a file named LFILE. 


BLOCK LFILE/L 


The following directives could cause four files to 
be combined in CRAY-1 blocked format. The first file - 


~ — —-might-be-a-controt statement fite,the-second mi 


be a FORTRAN source language file, the third might be 
a data file, and the fourth (in this example) is a 
binary file. All of the files reside on the Eclipse 
disk. 


/OUT BIGJOB 

CS 

SOURCE 

DATA 

PROGRAM B 

(RDOS end-of-file) 


In this example, all of the files to comprise a 
CRAY-1 input dataset are read from the card reader. 


The following command invokes the BLOCK program: 
BLOCK 
The card reader holds the following cards and decks: 
/QUT  JOBNAME 
$CDR 
(RDOS end-of-file) 
(control statements) 
/ EOF 
(source language program) 
/EOF 
(data) 
(RDOS end-of-file) 
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NAME : 
FORMAT : 
PURPOSE: 


SWITCHES: 


Global: 


Local: 


EXTENSIONS: 


EXAMPLES : 
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CAL (CRAY Assembly Language) 
CAL filename [binary/B] [list/L] 


To assemble a CAL assembly language source file. Output may 
be an absolute binary file, a listing file, or both. 


Detailed information about the CAL assembler is contained in 
the CAL Reference Manual, CRI publication 2240000. 


By default, the output of an assembly is an absolute binary 
file (no listing file). Switches not specified are ignored. 


/E List only lines with errors on listing file. /L or /P 
must also be selected. 


/L Listing file is produced. If Zist file is not speci- 
fied, fiZename.LS is used. 


/N No absolute binary file is produced. 


/O Override LIST pseudo instructions; ineffective if L or 
P switches not selected. 


/P Listing goes to printer; overriden by L switch. 


/X Cross referencing of symbol table; ineffective if L or 
P switches not selected. 


/B Binary on binary. Overridden by global /N switch. 

/L Listing is produced on Ztst; global L switch is 
required. 

On input, search for filename. 


On output, produce filename.SV for absolute binary and 
filename.LS for listing (If the global L switch is selected). 


The source file name specified on the call cannot have an 
extension and is limited to ten characters. 


CAL Z } 


This command causes assembly of CAL source file Z, producing 
absolute binary file Z.SV. 


CAL/N/L Ay 


This command causes assembly of file A, producing as output 
a listing file .LS. No binary file is produced. 


CAL/P/X EXAMP } 


This command causes assembly of file EXAMP, producing an 
assembly listing with cross-referenced symbol table, output 
to printer, and an absolute binary file named EXAMP.SV. 
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NAME 
FORMAT : 


PURPOSE: 


SWITCHES: 


Global: 


Local: 


DIRECTIVES: 
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DMP (Dump formatted binary file) 
DMP filename [dtrectives/D] Lltst/L] 


Formats all or selected parts of a binary file for listing 

on the printer. The list data may be directed to an alternate 
file as an option. Directives specify areas to be listed and 
whether data is to be formatted by words or parcels. 


None. 
/D Directives on named file. 
/L Listing is to go to named file. 


Directives specify areas of filename to be listed and spe- 
cify whether data is to be formatt-d by words or parcels. 
A directive assumes the following form: 


address, ,address PV comment (v signifies a blank) 


address, First word address, octal. 
address, Last word address, octal. 


P Parcel format; i.e., if P is specified, the dump 
presents information as 16-bit parcels rather 
than as 64-bit words. 


comment Arbitrary character string to identify dump. 


» 
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NAME : ED (Modify text) 
FORMAT : ED 
PURPOSE: ED allows the user to modify text from a source file and 


write the output to a destination file. (The source and 
destination file names may be the same, in which case the 
original source file can be saved with a .BU extension.) 


ED displays a page of instructions on the 455 console and 
waits until the user enters names for the source and 
destination files. At this point, a carriage return (a 
null source file name) will terminate the program; this is 
the only instance in which ED terminates itself. If the 
destination file name is null, it is assumed to be the 

same as the source file. If the source file name cannot be 
found, ED blanks the screen and redisplays the instruction 
page. 


Once ED has valid input and output file names, it displays 
the first 24 lines (one page) of the input file. The user 
positions the cursor to the location at which text modifi- 
cation is desired. The cursor is moved about on the screen 
using the space bar, the carriage return, and the five 
arrow keys in the group of 15 keys on the right side of the 
keyboard. 


Table 4-2 lists the keys that provide special functions 
with a single keystroke. 


Table 4-2. Special function keys 


Function 


Moves forward to fixed tab positions at columns 1, 
10, 20, 35, and 73. 


Destructive space; erases the current character. 


Destructive backspace key; overwrites the previous 
character with a blank. 


ESCAPE 


Blank function key 
RUBOUT 


LINE FEED Scrolls lines forward on the screen one at a time; 
does not change the cursor position. (The only way 
that the user can bring back lines that have been 
scrolled up and off the screen is to finish editing 
and then restart from the beginning of the resulting 
output file.) 


Hold down the LINE FEED and REPEAT keys for contin- 
uous scrolling. 


Finishes output for the file being edited and closes 
all files. 


END OF TEXT 
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Table 4-3. 


DELETE LINE 
INSERT LINE 
DELETE CHAR 
INSERT CHAR 
CLEAR TO EOL 


Blank function key 


Table 4-4, 


2240006 


Function 


Additional editing features can be obtained by using the 
SHIFT key in combination with some of the function keys. 
Table 4-3 summarizes the keys which can be prefixed by the 
SHIFT key to perform special functions in ED. 


Special function keys prefixed by the SHIFT key 


Deletes a line of text 
Inserts a line of text 
Deletes a character 
Inserts a character 

Erases to end of line 
Erases to end of tab field 


The HERE IS key functions (in ED only) as a true escape 
Character (the ESCAPE key having been pre-empted for the 
tab function). A number of editing features can be 
obtained by pressing the HERE IS key followed by another 
key. Table 4-4 summarizes the keys that can be prefixed 
by the HERE IS key. 


Special function keys prefixed by the HERE IS key 


Close up line one character (same as DELETE CHAR key) 
Delete one line (same as DELETE LINE key) 

Get one line into a one-line buffer (without deleting it) 
Insert one blank line (same as INSERT LINE key) 


Find next occurrence of a previously-specified search 
string. Searching continues beginning at the line 

after the one containing the cursor. HERE IS N does 

not blank the screen while searching unless it must scan 
more than 24 lines. 


Qpen up Tine one character (same as INSERT CHAR key) 
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Table 4-4. Special function keys prefixed by the HERE IS key (continued) 


+ ( 


SPACE 
RUBOUT 
RETURN 
LINE FEED 
ESCAPE 


. (period) 
# (not sign) 
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Put (insert) a line that was previously captured by a 
HERE IS G (get) or a HERE IS Y (yank). 


Initiate search for a given character string. User can 
specify up to 80 characters (with the assistance of the 
ESCAPE and RUBOUT keys). A carriage return terminates 
the reply. If the carriage return is entered while the 
cursor is in column one, no search is done and the 
original data is put back on the screen with the cursor 
position unchanged. 


Searching starts at the beginning of the line containing 
the cursor. HERE IS S always blanks the screen while 
scanning. HERE IS S followed by a carriage return is 
useful to refresh the screen from ED's memory if the 455 
has to be turned off and on again. 


Yank one line into a one-line buffer (also deletes the 
line). It is possible to move one line at a time by 
using HERE IS Y to yank the line from the display, fol- 
lowed by HERE IS P to put it back. A "yanked" line can 
be "put" any number of times. HERE IS Y deletes the 
yanked line; to get the line without deleting it, use 
HERE ISG... 


Disables output to the destination file. (This also 
turns off the top four indicator lights in the 455's 
Data-Panel. These lights are usually on to indicate 
normal output. ) 


Enables output to the destination file. (This turns on 
the top four indicator lights in the 455's Data-Pane]1. ) 


Destructive space (same as blank function key). 
Move cursor up one line. 

Move cursor down one line. 

Move forward in file one page (24 lines). 


Redisplay initial instruction page. A carriage return 
restores the text to the display screen. This series 
of three keystrokes can be used to refresh the screen 
from ED's memory if the 455 has to be turned off and 
on again. 


“Signals end-of-text and saves the input in a backup file. 


Signals end-of-text and cuts off output. 
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Of the two search commands, HERE IS N gives better 
feedback to the user than HERE IS S because the latter 
always blanks the screen. When. HERE IS N completes its 
search, the feedback given to the user depends on the 
amount of text that was scanned. 


- If the matching text was already on the screen, the 
cursor moves to the first character of the matching 
text. 


= If the match is made in the 24 Tines following the 
screen text, HERE IS N scrolls the screen until the 
match is made at the bottom of the screen, and the 
cursor is moved to the matching text. 


- If the match is farther away, HERE IS N: blanks the 
screen (just as HERE IS S always does). Then, when 
a match is found, it is displayed at the bottom of 
the screen, along with the preceding 23 lines. 


If no match is found in the file, the cursor stops at the 
end-of-file indicator, CJ. 


After making all desired changes to the file being edited, 
use one of the commands listed below to copy the rest of 
the input file to the output file. If the input and output 
files have the same name, the three commands have the 
following effect: 


END OF TEXT (no HERE IS prefix is needed) Discards the 
original text by deleting the input file and 


changing the name of the temporary output file. 


HERE IS . (remember as "dot") Saves the input file with 
a .BU extension before renaming the temporary 
output file. 


HERE IS # (remember as "not") Leaves the input file 
unchanged and discards the output. 


If the input and output files have different names, both 
END OF TEXT and HERE IS . merely copy the rest of the input 
to the output file. However, HERE IS # cuts off output 
immediately, so that the result is as if HERE IS ) had been 
entered, followed by END OF TEXT. 
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NAME: 


FORMAT: 


PURPOSE: 


SWITCHES: 
Global: 


Local: 
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QUT (Deblock and print dataset) 
OUT Cinds] Loutds] 


Converts a CRAY-1 blocked dataset (inds) to RDOS format on 
file outds. The default for inds is OUTPUT. The inds file 
must reside on the station disk. Files named $STATnnn.0OF 
can be referred to by the 2- or 3-digit number, mmm. 

For example, OUT 21 prints $STAT021. (Deblocking a file 
whose name is really only 2 or 3 digits, therefore, requires 
that the file be renamed first.) 


If the output file, outds, is named $LPT, it is printed. 
The default for outds is $LPT. 


The OUT program handles a maximum line length of 133 
characters from the CRAY-1 blocked input file (nde). 


The tnds file is not deleted from the Eclipse disk after 
it is printed unless the /D global switch is present. 

If it is deleted, it will be removed from the print queue 
when the station is re-initialized. 


/C Change unprintable bytes to blank characters. (Normally, 
they are translated to the s character.) 


/D Delete the input file when done. 


/E Force an end-of-file indication after each END statement. 
If /E is used alone, there is no effect. Using /E in 
conjunction with /F causes /EOF records to be written. 
Using /E with /P causes pages to be skipped. 


/F Qutput an /EOF record for each end-of-file in the blocked 
dataset. 


/P Skip to a new page after each end-of-file in the blocked 
dataset. 


/S Suppress printer format control. The first character of 
data in each record is not interpreted as a printer 
control character but is treated as ordinary data. 


/T Interpret tab characters (with tab positions 8, 16, 24,4...) 


None 


MESSAGES: 


Termination: 
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DELETED ftlename (if the /D global switch is present) 


nm UNPRINTABLE BYTES IN ftZename 


mn is a decimal number. If nn=0, this message is 
suppressed. 


m FILES 
m is a decimal number. The count includes end-of-file 


indications generated by the /E and /F global switches. 


If m=1, or if the /F global switch is absent, the 
message is suppressed. 
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NAME : 
FORMAT : 


PURPOSE: 


SWITCHES: 


Global: 
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RDF (Read foreign tapes) 
RDF Linput] Loutput] [pars/s...] 


RDF is a utility program for retrieving files from tapes 
that were written by computers other than the Data General 
Eclipse. RDF allows the user to process multiple tape 
files in many input formats. RDOS restricts the size of a 
record that can be read from tape to 4096 characters. 


The input file name, tmput, must be of the form MInim, 
where x is the tape transport number and m is a tape file 
number from 0 to 99. The default for zmput is MTO:9. 


The default for output, the output file name, is FILEX. 


Optionally, if the second parameter (normally the output 
file name) begins with the same four characters (i.e., MTn:) 
as the input file name, then the first and second parameters 
specify the first and last tape files and a third parameter 
specifies the names of the output files. This option 

allows tape files beyond MTn:99 to be read even though 

RDOS does not recognize the existence of more than 100 

files per tape. The format of the RDF command in this 

case is: 


RDF first last [output] 


Both first and Zast are of the form MIn:m; but the m that 
specifies the Zast tape file may be any number less than 

9999 and greater than the m specified for the first file 
(which must still be between 0 and 99). The third parameter, 
output, supplies a prefix to which numeric suffixes are 

added to form the names of the multiple output files. 

(See the /N local switch.) If output is omitted, the 

prefix FILE is used. 


Messages are written to the operator's console and, simul- 
taneously, to the file RDF.CM. Each time RDF is initiated, 
the old RDF.CM is deleted; if the messages are to be 
reviewed later, the user must capture RDF.CM with RENAME, 
DUMP, or PRINT. 


RDF rewinds the input tape after every run. 


/D Causes the end of each tape record to act as a record 
delimiter. 


7E Translates characters from EBCDIC to ASCII. 
NOTE 


The delimiter and terminator tests (/D 
‘ and /T local switches) are performed 
before the input characters are translated. 
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Local: Local switches are used to specify decimal values only; 
any parameter having a local switch must be a string of 
decimal digits. 


/L 


/D 


/T 


/B 


/E 
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Record length in characters; allowable range is 
from 2 to 513. The default is 80. 


Decimal value of logical record delimiter; allowable 
range is from 0 to 127. The default is no delimiter. 
If there is no delimiter, the logical records have a 
fixed length defined by the /L parameter. Ifa 
delimiter is defined by /D, the logical records may 
be of variable length with a maximum defined by /L. 


Decimal value of logical file terminator; allowable 


range is from 0 to 127. The default is no terminator. 


If a terminator is defined by /T, the first character 
of each record is compared to the terminator and, if 

there is a match, the current record and all records 

remaining in the file are discarded. 


Beginning logical record number (divided by 1000) to 
be copied from the tape file; allowable range is 
from 0 to 32767. The default is 0, which means that 
copying starts with logical record 0. 


Endina logical record number (incremented by 1, then 
divided by 1000); allowable range is from 0 to 
32767. The default is 0, which means that copying 
will not stop until 65,536,000 logical records are 
output, unless the end of the tape file (or mass 
storage overflow) occurs first. 


Segment size for multiple segmentation of a single 
tape file. The /S parameter specifies the number of 
logical records to be written to each file segment. 
All segments are created in one pass through the 
tape file, and all but the last segment created must 
contain the same number of records. Allowable 
values are from 0 to 32767. The default is 0 (no 
multiple segmentation). 


Note that /S is mutually exclusive with /B and /E, 
which are used to create only one (usually very 
large) segment at a time. Also, /S cannot be used 

if there is more than one tape file to be processed; 
that is, where parameters 1 and 2 are used to specify 
a range of file numbers. 
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EXAMPLES : 
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/N Number to be added to file-name suffixes. (See 
examples.) Allowable range is 0 to any number that 
will not overflow 9999 when added to the standard 
file-name suffixes. The default is to use standard 
numeric suffixes defined as follows: 


When reading multiple tape files, the multiple 
output file names are given suffixes that 
correspond to the RDOS-assigned tape file numbers. 


When creating multiple segments from a single 
tape file (see /S), the output file names are 
given ascending numeric suffixes beginning with 0. 


The filé name suffix becomes an extension if the output 
file name ends with a period. Whether or not there is a 
period in the file name, the user must be careful to avoid 
truncation of the suffix. RDOS allows ten characters before 
the period and two after it. (The portion of the name after 
the period is called the file name extension.) In the 
following example, the first and last tape files will be 
written to LONGNAME19 because the eleventh character in 

the name is discarded. 


RDF MT9:10,100 LONGNAME 


In the next example, B.19 will be written twice if there are 
more than 4000 lines in MT@:2. 


RDF MTO:2 B. 49/S 


RDF 


This command copies information from MT@:@ to FILEX in 
the current directory, assuming that each logical record 
on the tape is exactly 80 characters (that is, the tape 
records contain no carriage returns or other special 
characters used as delimiters). The length of each 
physical tape record is immaterial so long as it is 

less than or equal to 4096 characters. 


RDF MT@:1 MT@:269 132/L 13/D 


This command copies 200 files from the tape in one run, 
creating 200 new files named FILE1 through FILE200 in the 
current directory. Each record is assumed to be terminated 
by a carriage return (decimal value 13), but the maximum 
record length is set to 132 so that no line can be created 
that is too long to be printed. The carriage return 
terminators are discarded. 
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RDF/E MT@:99 XYZ 27/L 


This command copies all of MT@#:99 (the last file on the 
tape that can be specified in the first parameter) to a 
file named XYZ. Each record is assumed to be exactly 27 
characters long. The global switch /E causes the input 
to be translated from EBCDIC to ASCII- 


RDF MT@:4 SPQR 16¢0/S 1/N 


This command breaks up a large file (MTQ:4) into smaller 
files to make them more manageable. The files created on 
disk by the above command will be named SPQR1, SPQR2, and 
so on. 


Suppose MT@:4 consists of 25192 80-character logical records. 
Then, the last file created will be SPQR26, containing 192 
records, with the first 25 files (SPQR1 through SPQR25) 

each containing 1000 records. Any segment size from 1 to 
32767 may be specified, but it must apply to all segments 

in the file. 


RDF MT@:0 PART1 @/B 4@/E 
Reads the first 40,000 records from MT@:@. 
RDF MT@:@ PART2 46/B 8@/E 


Reads the next 40,000 records from MT@:9, and so on. RDF 
rewinds the tape after each call. If the tape file has, 
for example, 110,000 records,*then the last 30,000 records 
can be read by specifying '89/B' and 'xxx/E' where xxx is 
110 or greater; or the /E parameter could be omitted. 


RDF MT@:@ SOLO! 16/D 25/T 


This command reads the first file from the Concurrent 
Pascal distribution tape. The records are variable length 
with line feeds as delimiters. The last actual record of 
the file is immediately followed by a CONTROL-Y (decimal 
25). The line feed terminators are discarded. 


RDF MT@:<1,115> SOLO1 1@D 25/T 1/N 


This command reads the 115 files that make up the Concurrent 
Pascal distribution tape (except MT@:@, which describes the 
other 115). The 1/N parameter is used to force the file 
names to begin with 'SOL02' instead of 'SOLO1' so that the 
files may be referenced by the number assigned them by 

their accompanying documentation. 


RDF/D MT@:@ UNBLOCKED 


This command assumes that the tape file contains one (perhaps 
variable-length) logical record in each physical tape record 
and that the maximum record length is 80 characters. (If 

any ‘tape record were longer than that, it would be divided 
after every 80th character.) 
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NAME: READ (Card to disk transfer) 
FORMAT : READ file (Site. nea 
2 
PURPOSE: Read cards at the card reader and store the images on the 


specified file. More than one file may be read with a single 
command. Existing files are deleted; the new files are created 
as random files. A card with rows 6, 7, 8, and 9 punched in 
column 1 is interpreted as an end of file; rows 12, 11, and 0 
through 5 are not examined. 


This utility should be used instead of the RDOS XFER command. 
SWITCHES: None. 
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NAME : 


FORMAT : 


PURPOSE: 


SWITCHES: 
Global: 
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UPDATE (Source maintenance program) 
UPDATE file [afile/s...] 


Maintain source language decks on disk files in updatable 
format. Details of UPDATE are given in the Data General 
UPDATE Reference Manual, CRI publication 2240007. Note that 
a "program library" always contains exactly one deck, even 
though the term "library" suggests multiple decks. 


/G UPDATE generation mode. The G global switch is selected 
when a program library is to be generated from a source 
file. This switch overrides all other global switches. 


/S Source file generation mode. The S global switch is 
selected when a source file is to be written from a 
program library. No input file (.IN extension) is read. 
The S switch overrides all other global switches except G. 


/C Write compressed compile file. Ignored if G or S global 
switches are selected. Selecting no global switches is 
the same as selecting only. C. 


/A_ Write uncompressed compile file (alternate form). Ignored 
if G or S global switches are selected. /A does not over- 
ride /C. UPDATE prefixes the sequence information with a 
semicolon when the A global switch is selected. The /A 
switch is used when the compile file is to be used as 
input to a Data General assembler; the semicolon places 
the sequence information in the comments field. 


/N Write new program library. Ignored if G or S global 
switches are selected. No new program library is written 
if the N global switch is not selected. 


/E List only errors in the listing file. 


At least one file name is required as a parameter on the 
UPDATE call. If no local switches appear with the file 
name (1fn), UPDATE assigns the following default names: 


lfn. Compile file 

1fn.SR Source file 

lfn.PL Program library file 
lfn.IN Input file 

Tfn.NL New program library file 
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SWITCHES: (continued) 


Local: Alternate file names may be specified by using 
local switches: 


/A_ Compile file 

/C Compile file 

/I Input file 

/N New program library 
/P Program library 

/S Source file 

/L Listing file 
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STATION INPUT DIRECTIVES’ 5 


INTRODUCTION 


An input file or deck consists of station directives and CRAY-1 data. 
When processing input via the BLOCK command the station interprets the 
directives and formats the data into blocked datasets which are then 
queued for transfer to the CRAY-1. 


The station directives in the input file (1) identify the dataset type, 
(2) specify station files containing additional directives and data, and 
(3) control blocking of the datasets. 


A station directive is characterized by a slash in column one of an input 
record followed by a valid directive verb. The first three characters of 

the verb (shown underscored in the descriptions of directives) are sufficient 
for identification of the directive. 


Directives include the following: 


/SAVE Identifies permanent dataset. 

{SUBMIT Identifies job input dataset. 

/CONTINUE it as source of directives and data to alternate 
ile. 

{RETURN Returns to primary source of directives. 

/EOF Inserts CRAY-1 end-of-file RCW into dataset. 

/EOD Inserts CRAY-1 end-of-data RCW into dataset. 


INPUT FILE STRUCTURE 


A station input file contains directives and data that describe one or 
more CRAY~1 datasets. 


The set of directives describing a job input dataset begins with a /SUBMIT 
directive; the set of directives describing a staged permanent dataset 
begins with a /SAVE directive. In either case, the directive set is 
terminated by a /EOD or, if reading from the main input file, by an RDOS 
end-of-file. 

Deferred implementation. 
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Input file data consisting of directives and data may originate from: 


1. The main input file, that is, the file specified on the BLOCK 
command (section 3). 


2. An alternate input file, that is, a file referenced by a 
/CONTINUE directive. 
A /CONTINUE directive in an alternate input file causes that file to be 
closed and a new alternate input file to be opened. Control returns to 
the main file if a /RETURN or an RDOS end-of-file is encountered. 


The /EOF and /EOD directives, the /RETURN directive, and the RDOS end-of- 
file control blocking. An /EQF directive or an RDOS end-of-file on an al- 


ternate file generates an end-of-file RCW and terminates the current block. 


An /EOD directive or an RDOS end-of-file on the primary input file gener- 
ates an end-of-file RCW and terminates the block. The /RETURN directive 
allows a user to return from an alternate source to the primary source 
without writing an EOF or EOD RCW on the dataset and without beginning 


a new block. 

DIRECTIVES 

/SAVE Identify permanent dataset 

FUNCTION: Identifies the dataset as a staged permanent dataset to 
be staged to the CRAY-1 with disposition code (DC) of 
stage (ST) and permanent dataset name (PDN) as specified 
on the directive. 

FORMAT : /SAVE ,pdn 
pdn 1-15 character name of permanent dataset. First 


character must be alphabetic. 
/SUBMIT - Identtfy job input dataset 


FUNCTION: Identifies the dataset as a job input dataset to be staged 
to the CRAY-1 with a dispostion code (DC) of input (IN), 
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FORMAT : /SUBMIT 


/CONTINUE - Continue source from alternate file 


FUNCTION: Switches to alternate file for source of directives and 
data. This file is read until another /CONTINUE, a /RETURN, 
or an RDOS end-of-file is encountered. 


FORMAT : /CONTINUE , fiZename { BINARY } 


filename Name of RDOS file containing dataset directives and 
data. 


BINARY If this parameter is present, the file contents are 

assumed to be binary and the station does not look 
for directives. All binary data is blocked in the 
dataset. 


If BINARY is omitted, the file contents are assumed 
to contain ASCII data and may include directives. 
/RETURN - Return to previous source of station input 


FUNCTION: Returns from current alternate file to main input file. 
No CRAY-1 end-of-file RCW is generated with a RETURN. 


FORMAT : /RETURN 


/EOF .- End-of-file RCW 


FUNCTION: Inserts a CRAY-1 end-of-file record control word into the 
dataset. 
FORMAT : /EOE 


/EOD - End-of-data RCW 


FUNCTION: Inserts a CRAY-1 end-of-data record control word into the 
dataset and queues the dataset for staging to the CRAY-1. 


FORMAT : /EOD 
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EXAMPLES 


These examples illustrate different methods of building a dataset consist- 
ing of two files. 


1. The primary source file is EX1. The station command BLOCK,EX1 ,) 


causes the station to begin reading from this file. 
Contents of EX1: 
/SAVE, EXAMPLE Input is staged permanent dataset named EXAMPLE. 
/CONTINUE,FILE1 Input switches to alternate file, FILE1. 
/CONTINUE,FILE2 Input switches to alternate file, FILE2. 
(RDOS end of file) Insert EOD RCW and queue dataset. 
Contents of FILE1: 
RECORD 1. Record is blocked onto dataset. 
(RDOS end of file) Insert EOF RCW and return to EX1. 
Contents of FILE2: 
RECORD 2. Record is blocked into second file of dataset. 


(RDOS end of file) Insert EOF RCW and return to EX1. 


2. The primary source file is EX2. The station command BLOCK,EX2 9)” 
* causes the station to begin reading from this file. 
Contents of EX2: 


/SAVE, EXAMPLE Input is staged permanent dataset named EXAMPLE. 
RECORD 1. Record is blocked onto dataset. 
/EOF Insert EOF RCW. 
RECORD 2. Record is blocked into second file of dataset. 
/EOF Insert EOF RCW. 
(RDOS end of file) Insert EOD RCW and queue dataset. 
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3. The primary source file is EX3. The station command BLOCK,EX3 » 
causes the station to begin reading from this file. 


Contents of EX3: 


/ SAVE, EXAMPLE Input is staged permanent dataset named EXAMPLE. 
/CONTINUE, FILE3 Input switches to alternate file, FILE3. 
(RDOS end of file) Insert EOD RCW and queue dataset. 
Contents of FILE3: 
RECORD 1. 
/EOF 
/CONTINUE,FELE4 
(RDOS end of file) 
Contents of FILE4: 


Record is written on dataset. 
EOF is written on dataset. 
Input switches to alternate file, FILE4. 


RECORD 2. Record is written on second file of dataset. 
/EOF EOF is written on dataset. 
/RETURN 


Input switches to primary file. 
(RDOS end of file) 
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STATION ERROR TERMINATION 6 


The Data General Station aborts execution upon encountering either of two 
classes of errors: 


Class l 


Errors involving a critical resource. In this instance the station provides 
information via an error code which may enable the operator to diagnose and 
remedy the cause of the problem and reinitiate station execution. 


Class 2 


Inconsistencies in the internal state of the station. This class of 
errors cannot normally be remedied by operator action. An image of sta- 
tion memory at the time of the error is saved for analysis of the problem. 


The method of termination depends upon the class of the error encountered 
and whether the station was executing in background or foreground mode. 


BACKGROUND STATION TERMINATION 


Class 1 


The station terminates with the following error message appearing on the 
1440, display screen. 

UNKNOWN ERROR CODE code: stat.SV 
stat.SV is the station file which was executing at the time. code is a 
five digit octal error code. Refer to table 6-1 for an explanation of 
the error and suggested remedial action. 


Class 2 

The station terminates with the message BREAK appearing on the 1440 display 
screen. An image of station memory is contained in the file BREAK.SV. 

A copy of this file should be written to tape and submitted to Cray 
Research through Software Problem Report procedures. 


2240006 6-1 E 


FOREGROUND STATION TERMINATION. 


For both class 1 and class 2 errors, the station terminates with the 
message FG TERM appearing on the 1440 display screen. An image of station 
memory has been captured in the file FBREAK.SV. It is necessary to print 
a portion of this file to determine the error type. Enter: 

FPRINT/L FBREAK.SV 342/F 357/T ) 


Class 1 


The ascii text ERROR: appears in locations 342-344. Word 345 contains 
the error code to be used in conjunction with table 6-1 to diagnose the 
problem. 


EXAMPLE : 


344 ---- ---- 842522 @51117 @51672 814057 aaanEe Boaw@GA .... ERROR: .-.... 


350 B80888 GA60B8 BEBRGH 0352828 032212 32776 432320 A92356 ...... 4.4, 454P4~> 


14057 is the error code. 


Class 2 


The ascii text BREAK appears in words 342-344. The file FBREAK.SV should 
be saved and a copy submitted to Cray Research for analysis through a 
Software Problem Report (SPR). 


ss 


= z ® a J a > 


EXAMPLE: 


348 ----  ---- 841122 842501 645448 gage@Ae G17641 177777 ....BREAK ...!.. 
3564 827771 B20363 GBBOER 832620 832212 432278 32324 B32536 7y s..4.4.484P47 
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Table 6-1. Error code descriptions 


|code’ | Meaning | Causes, solutions 


1. CLEAR/A and reboot system 
aa 


2. Disk errors 
Error initiating a task 


10nnn Error defining the 455 
Data Screen interface 
12000 


a 
15unn 
+ 


16000 
00403 


tann - RDOS error code. Refer to RDOS User's Handbook (093-000145) 
for error code descriptions. 


Error opening, reading, 
or closing the command 
file COM.CM (FCOM.CM 

for foreground station) 


. Not linked to stat.OL file 
. File stat.OL linked to itself 
File stat.OL not contiguous 

. CLEAR/A and reboot system 


Error opening the 
station overlay file, 
stat.OL 


RPWNMYR 


1. Station generated improperly (RLDR) 
See a systems analyst 


1. CLEAR/A and reboot system 


1. Boot proper RDOS system 


. File linked to itself 

. Disk nearly full so that files 
cannot be created 

3. Files in use by another program 

4. CLEAR/A and reboot system 


Invalid real time clock 
rate 


Error opening 
DPO:$STAT.IQ or 
DPO:$STAT.0Q file 


Nor 


1. File not contiguous 

2. File less than 81 blocks (41472 
characters) in length 

3. File read or write protected 

4. Disk errors 


Error reading or writing 
DPO:$STA.IQ or 
DPO:$STAT.0Q during 
initialization 


1. Delete DPO:$STAT.IQ or DPO:$STAT.0Q 


Invalid identifier in 
file DPO:$STAT.IQ or 
DPO:$STAT.0Q (First 
word of file must be IQ 
or 0Q respectively) 


Insufficient buffer 
space 


. Boot proper RDOS system 

. Station generated improperly (RLDR) 
. Foreground program running with the 
background station 


wnMre 
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Table 6-1. Error code descriptions (cont. ) 


Meaning | Causes, solutions 


Error reading a station . stat.OL not a contiguous file 
overlay 2. Disk errors 


Error reading or writing | 1. File not contiguous 
DPO:$STAT.IQ or . File less than 81 blocks (41472 
DPO:$STAT .0Q characters ) 

. File read or write protected 

. Disk errors 


+ ; 


mnn - RDOS error code. Refer to RDOS User's Handbook (093-000145) 
for error code descriptions. 
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CHARACTER SETS 
Character Card Punch 
NUL 12-0-9-8-1 
SG 12-9-1 
SEX 12-9-2 
HTX 12-9-3 
LOL 9-7 
ENQ 0-9-8-5 
ACK 0-9-8-6 
REL 0-9--8-7 
BS 11-9-6 
HT 12-9-5 
LE 0-9-5 
ae 12-9-8-3 
FE 12-9-8-4 
GR 12-9-8-5 
so 12-9-8-6 
SI 12-9-8-7 
DLE 12-11-9-8-L 
NOL 11-9-1 
ne2 1199-2 
DC3 Ll-9-3 
DC 4-8-9 
NAK 9-8-5 
SYN 9-2 
ETB 0-9-6 
GAN 11-9-8 
LM 1LL-9-8-1 
SUH 9-8-7 
ESC 0-9-7 
FS 11-9-8-4 
GS 11-9-8-5 
RS 11-9-8-6 
US 11-9-8-7 
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ASCII Code 


000 
001 
002 
003 
004 
00s 
006 
007 
010 
OL 
012 
013 
ol4 
ols 
016 
017 
020 
021 
022 
023 
o24 
025 
026 
027 
030 
031 
032 
033 
034 
035 
036 
037 


A-1 


ow mN DN FP WH HO &*& OW ss 


oe 


Card Punch 


NO PUNCHES 
12-8-7 
8-7 
8-3 
11-8-3 
0-8-4 
12 

8-5 
12-8-5 
11-8-5 
11-8-4 
12-8-6 
0-8-3 
il 
12-8-3 
0-1 


io) 


CN DR OH eR &O wD & 
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ASCII Code 


040 
NAL 
042 
043 
O44 
045 
046 
047 
050 
OSL 
052 
053 
054 
055 
056 
057 
060 
061 
062 
063 
064 
065 


Character 


C 
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Card Punch 


8-4 
{2-1 
12=2 
12-3 
12-4 
12-5 
12-6 
12-7 
12-8 
12-9 


‘ASCII Code 


100 
101 
102 
103 
104 
105 
106 
107 
110 
111 
112 
113 
114 
115 
116 
117 
120 
121 
122 
123 
124 
125 
126 
127 
130 
131 


wh 


ber 


Character Card Punch 


82] 
12-0-1 
12-0-2 
12-0-3 
12-0-4 
12-0-5 
12-0-6 
12-0-7 
12-0-8 
12-0-9 
12-11-1 
12-11-2 
12-11-3 
12-11-4 
12-11-5 
12-11-6 
12-11-7 
12-11-8 
12-11-9 
11-0-2 
11-0-3 
11-0-4 
11-0-5 
11-0-6 
11-0-7 
11-0-8 
11-0-9 
12-0 
12-11 
11-9 
11-0-1 
12-9-7 


ASCII Code 


140 
14) 
142 
143 
144 
145 


146 | 


147 
150 
15] 
152 
153 
154 
155 
156 
157 
160 
161 
162 
163 
164 
165 
166 
167 
170 
171 
172 
173 
174 
175 
176 
177 
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EQUIPMENT OPERATION B 


This section gives a brief summary of the procedures that an operator 
will be expected to perform on a day-to-day basis for the disk drive, 
the printer/plotter, and the card reader. Consult the manufacturer's 
publications for additional procedures or when in doubt about one of 
these procedures. 

Device Publication 


Calcomp Model 114D Disk Drive Calcomp Model 114D Disk Drive Technical 
Manual, Part No. 76199-100 


Documation M-1000 Card Reader Documation M-1000 C Card Reader Technical 
Manual, Document No. M1026. 


Gould 5000 Printer/Plotter Gould 5000 Printer/Plotter Operation, Service 
and Maintenance Manual, Pub. No. 94-2-50006-1 


CALCOMP MODEL 114D DISK DRIVE 


Pancha hnsiine venue Ovens nT nn ne ne Eaten 


DISK PACK EXCHANGING 

1. Make certain that the POWER ON indicator is not lighted and that the 
disk pack is not spinning. If the POWER ON indicator is lighted, 
press it to turn off the light and stop the drive. 

2. When the disk pack has stopped, press the cover latch (figure B-1) 
and lift the cover. 

3. Place the disk pack cover over the loaded disk pack so that it engages 
the spindle. Turn counter-clockwise until the spindle clicks and lift 


the cover and disk pack from the drive. 
POPPPPORODOP POOP ODOE DOPOD DDD DDOD ODD IO DP LD OD DL DILDO LO DDI DLE DOOLEY, 
CAUTION 
Place one hand under the disk pack to prevent 


_the disk pack from falling free of the cover. 


POPOPOPDOOPPOOO OL OP ODDO ODL LODO DODO OOOO ODO DODOODDODOOCDOODIIN 


4. Using its cover as a handle, place the new disk pack slowly over the 


spindle until it engages the spindle drive unit. Turn the disk pack 
cover clockwise until it reaches a stop. Lift the disk pack cover from 
the pack. 
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Close the main ecever making sure—that it latches. 
Press the POWER ON switch. 


POWER ON SWITCH 


Figure B-1: CALCOMP Model 114D Disk Drive 
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GOULD 5000 PRINTER/PLOTTER 


POWER ON 


In order for the system.to operate, the printer/plotter must be 
powered on with. all interlocks satisfied. In addition, the printer 
must be placed in REMOTE mode to be accessible to the computer 
interface. Refer to figure B-2. 

1. Press POWER; the indicator should light. 

2. Press REMOTE; the indicator should light. 


POWER OFF, PAPER LOW, ETC. 


To power down the printer/plotter, thus making it inaccessible to the 
computer, perform the Power On sequence in reverse. 


To terminate any operation in progress, press REMOTE to place the 
place the printer in local mode. 


To extract any output remaining out of view, press the REMOTE switch and 
the the PAPER LOW switch. 


After performing local operations, remember to return the printer to 
remote mode by pressing REMOTE. 
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Figure B-2. Gould 5000 Printer/Plotter 
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DOCUMATION M-1000 CARD READER 


LOADING THE INPUT HOPPER 


Load the input hopper with punched cards to be read as follows: 


a. Pull the hopper follower back with one hand and load the card 
deck into the hopper area; the first card to be read must be 
placed at the front with the "9" edge down, column "1" to the left. 
Continue placing cards into the hopper until it is loosely filled 
(approximately 1000 cards). 


PRP PPP PLD PLP PDD DG DDD DGD DPLDDOL OD LOD DD DL OLLI DDG DOLD DON 


CAUTION 


Do not pack the input hopper 
so full that the riffle action 
is inhibited. 


PPP PPP POPP PP DPIDPDD DDD DLP OL DO DOD ODOC DLO LOO ODL OD DOPE 


b. |The hopper may be loaded while cards are being read if the operator 
is careful to keep tension on the front portion of the deck while 
loading additional cards at the rear. This is accomplished with 
the input hopper approximately one-half to one-third full. Use 
just enough pressure to maintain the riffle action. 


c. Unloading the input hopper is the reverse of the loading procedure. 
Normally all cards are processed through the reader; however, if it 
is necessary to unload the hopper, pull the follower back and remove 
the card deck. 


UNLOADING STACKER 
To unload the stacker, perform the following steps. 


a. Pull stacker follower forward with one hand and remove the 
front or rear portion of the card deck from the stacker area, 
being careful that the deck order is maintained. 


b. To unload stacker during operation, pull stacker forward and 
remove portion of deck taking care to allow stacker plate to 
return to its normal position gently. 


CONTROLS AND INDICATORS 


Reader controls and indicators are located on the front control panel, 
(figure B-3) the rear of the card cage, and the rear subframe. 
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Documation M-1000 Card Reader 
B-6 


Figure B-3. 
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CARD READER OPERATIONAL PROCEDURES 


The following procedures explain both the operational sequence and some of 
the theory associated with the controls and indicators for the card reader. 


a. 


2240006 


Place the AC power circuit breaker in the ON position to allow 
power ON/OFF contrel from the front panel. 


Select the mode of operation, MANUAL or AUTO. When the MANUAL mode 

is selected, the drive motor and vacuum/blower will run continuously 
when AC power is applied. When the AUTO mode of operation is selected, 
all motors will turn off after the last card is read. 


The second mode switch is used to select either REMOTE or LOCAL oper- 
ation. When LOCAL operation is selected, card reader operations are 
controlled from the operator's control panel. In normal operation 
the card reader is connected to the appropriate interface logic and 
the switches should be in AUTO and REMOTE positions. 


With the LOCAL mode of operation established, press the POWER 
switch on the front panel to apply primary power to the reader. 
The drive motor and vacuum/blower will not come on at this time 
due to the input hopper being empty and AUTO shutdown selection. 


Press the LAMP TEST switch and check that all front panel indicators 
are lighted. 


Load the input hopper and press the RESET switch. The RESET switch 
is a momentary action pushbutton indicator used to clear any error 
conditions and establish the card reader "ready" condition. When 

the "ready" condition is established, the RESET indicator will light 
green. All motors will start and riffling action begins on the first 
half inch of cards. 


As the cards are being read, the PICK CHECK indicator will light if 
a card has failed to reach the read head after a pick command has 
been given. Inspect the cards in the input hopper for excessive 
leading edge damage, interlocked webs or cards stapled together. If 
no apparent card damage is present, check for excessive card warpage. 


The READ CHECK indicator will light and the "stop" condition will be 
established when any of the following conditions. are detected. 


Failure of leading or trailing edge dark check. 
Failure of trailing edge light check. 

Card slippage. 

Control logic failure. 


Pwn— 


i. The STACK CHECK will light if the previous card read has not reached 
the output stacker. Check the card track to make sure it is clear 
and check the output stacker for incorrectly stacked cards. 


j. The HOPPER CHECK indicator will light when the input hopper is empty 
or when the output stacker is full. This is formal operation. 


k. The STOP switch is a momentary action pushbutton switch indicator 
used to terminate card reader operation at the end of a ready cycle. 
The STOP indicator will light red when the "stop" condition is 
established. 
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DISK PACK PROCEDURES — C 


INITIALIZATION 


a 


The following procedure tells how to load the Eclipse station software 
from the deadstart tape onto the Eclipse disk pack. Procedures for 
generating this tape are provided in the CRAY-OS System Programmer's 
Handbook, Cray Research publication 2240012. 


Perform the initialization procedure whenever the RDOS disk pack becomes 
unusable (for any of a myriad of reasons, usually indeterminable). There 
are two levels of initialization: partial and full. 


PARTIAL INITIALIZATION | 


A partial initialization is less severe than a full initialization and 
involves replacing the disk copy of RDOS with a new copy from tape. No 
files are lost in this process. The recommended procedure is to first 
attempt a partial initialization although it seldom seems to correct any 
disk pack problem. 


This procedure assumes that the operator has performed the Power On 
procedure given in section 2. 
1. Mount the current RDOS deadstart tape on tape unit O and press LOAD 

and ONLINE. 

Flip up the RESET/STOP switch. 

Set the Eclipse panel switches to 100022,. 

Flip up the PR LOAD switch. 

The tape moves slightly as the first file is loaded into Eclipse memory. 
5. The following dialog then occurs at the 1440 display terminal. 


Message Operator response 
a FROM MTO:. 2 > 
b. FULL(F). OR PARTIAL (P OR <CR>)? > 
c. INITIALIZING WHAT DISK? DPO » 
d. DATE (M/D/Y)? mm/dd/yy ,) 
e TIME (H:M:S)?, hh:mm:ss » 


The partial initialization is complete when R appears. 


2240006 C-1 E 


FULL INITIALIZATION 


If a partial initialization fails to correct the problem, a full initial- 
ization is indicated. A full initialization takes about 5 minutes and 
destroys all disk fites. 


NOTE 


For a particularly severe problem or for a new pack, 
first reformat the pack as described in the next 
section of this appendix. 
a 


1. Perform steps 1 through 5a as for a partial initialization. 


2. Respond F ? to the message FULL(F) OR PARTIAL (P OR <CR>)? and complete 
steps 5c through 5e. 


3. Enter the following commands: 


INIT MTO > 

LOAD/A MTO:(3,6,9) > 

After the files have been loaded, the tape rewinds and R appears. 
c. RELEASE DPO > 

The message MASTER DEVICE RELEASED appears. 


. Set the Eclipse panel switches to 100022,. 
5. At the Eclipse, flip up the PR LOAD switch. 
6. The following dialog then occurs at the 1440 display terminal. 


P Message Operator response 
a. FROM MTO: 5} 
b. BOOTSTRAP DEVICE SPECIFIER? DPO > 
c. INSTALL BOOTSTRAP (Y OR N)? Y 


The console bell sounds. There is no other response. The disk 


bootstrap program is now on disk enabling subsequent disk recoveries 
without tape. 


The pack has been initialized and released. It can be powered off 
and removed or the RDOS system can be activated in the normal program 
initialization procedure. 


2240006 C-2 E 


a 


a ee ee ee ee ee ee ee ee ee 


“f 


FORMATTING AN ECLIPSE DISK PACK 


Data General programs provide for formatting and flaw testing of a disk 
pack. The current formatting program is the RDOS Rev. 6 program, DKINIT. 
If this program fails, the RDOS Rev. 4 program, DPDF may need to be run. 


REV 6 FORMATTING PROCEDURE 
This procedure assumes that the Power On procedure has been performed. 
1. Mount the current RDOS tape onto magnetic tape unit 0 and press LOAD 
and ONLINE. 
Mount the pack to be formatted and power on the disk drive. 
At the Eclipse: 
a. Flip up the RESET/STOP switch. 
b. Set the Eclipse panel switches to 100022,. 
c. Flip up the PR LOAD switch. 


The tape moves slightly when the first file is loaded into Eclipse 
memory. 


4. The following dialog then occurs at the 1440 display terminal. 


Message Operator response 
FROM MTO: 4 > 


DISK INITIALIZER - REV. 06.20 
DISK DRIVE MODEL NUMBER? 4057 ) 


y 
4057 DRIVE TYPE 
DISK UNIT? DPO > 


COMMAND? FULL ) 


COMMAND DESTROYS ANY PREVIOUS DISK 
STRUCTURE RDOS INIT/F MUST BE DONE 
ON DISK AFTER COMMAND TYPE CONTROL- 
A NOW TO ABORT WITHOUT LOSS. 


NUMBER OF PATTERNS TO RUN (1-5)? 1 > Enter 5 if 
formatting 
new pack. 


ona *o 
ee «® e 


we PATTERN # 1 (155555) *** 


Formatting begins and takes about 10 
minutes per pattern. If any bad blocks 
are discovered, a message appears on the 
screen and the bad block address is 
recorded by the program in the bad block 
table. 


t 
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“NOTE 


If a large number of flaw messages appears or if 
the message DRIVE UNSAFE OR ADDRESS ERROR appears, 
refer to Rev 4 formatting procedure. 


Message Operator response 


f. DO YOU WISH TO DECLARE ANY BLOCKS BAD THAT 
ARE NOT ALREADY IN THE BAD BLOCK TABLE? NO 


wa 


g- DEFAULT REMAP AREA SIZE IS 12 BLOCK(S) 
LONG IT NEEDS TO BE AT LEAST 0 BLOCK(S) 
LONG REMAP AREA SIZE (TYPE RETURN FOR 
DEFAULT )? » 


h. REMAP AREA START BLOCK NUMBER 
(TYPE RETURN FOR DEFAULT)? » 


i. DEFAULT FRAME SIZE IS 83, 
MIN IS 1, AND MAX IS 4060 
DISK FRAME SIZE (TYPE RETURN FOR 


DEFAULT)? > 
Jj. FULL DISK INIT COMPLET 
COMMAND? . STOP ) 


REV 4 FORMATTING PROCEDURE 


An,apparent deficiency in the Rev 6 Disk Initializer may cause it to abort 
with the message DRIVE UNSAFE OR ADDRESS ERROR. This necessitates running 
the Rev 4 Formatter, DPDF, followed by repeating the Rev 6 procedure. 
1. At the Eclipse panel: 

a. Set the panel switches to 100022,. 

b. Flip up the RESET/STOP switch. 

c. Flip up the PR LOAD switch. 


2. At the 1440 display terminal, respond 10 to the message FROM MTO. 
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3. At the magnetic tape unit: 
a. Press RESET and REWIND. 
The tape rewinds. 
b. Press RESET and ONLINE. 
4. At the Eclipse panel: 
a. Set the panel switches to 000000. 
b. Flip down the START/CONT switch. 
c. The message TYPE UNIT NUMBER appears, respond with 0) 


Formatting begins and takes about 8 minutes after which the 
message FORMATTING DONE appears. 


5. Repeat the Rev 6 formatting procedure. 
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COMMAND RESPONSES 


ALREADY LOGGED ON 
CHANNEL ERROR 
CHANNEL PARITY ERROR — 
CONCENTRATOR FUNCTION REJECT 
CRAY-1 FUNCTION REJECT 
CRAY-1 MESSAGE RETRY COUNT EXCEEDED 
CRAY-1 NOT RESPONDING 
CREATE ERROR: RDOS message’: ftlename 
CTRL-A PAUSE 
DELETE ERROR: RDOS message’: filename 
FILE IS EMPTY: fidename 
FILE NOT RANDOM OR CONTIGUOUS: fiZename 
FILE STATUS ERROR: RDOS message’: filename 
FUNCTION RESTRICTED TO OPERATOR 
ILLEGAL FORMAT FOR INFORMATION 
ILLEGAL INFORMATION FOR MODE 
ILLEGAL MODE FOR DEBUG FUNCTION 
Refer to CRAY-OS System Programmer's Handbook for debug functions. 
ILLEGAL REQUEST FOR MODE 
INCOMPATIBLE SEGMENT SIZE 
INVALID COMMAND KEYWORD: Keyword 
INVALID CONCENTRATOR REPLY MESSAGE 
INVALID FILE NAME: filename 
INVALID PARAMETER: parameter 
LINE ALREADY ACTIVE 
LINE NOT ACTIVE 
LINE NOT INITIALIZED 
NO BUFFER SPACE AVAILABLE 
NO RDOS CHANNEL -AVAILABLE 


TRefer to Data General: documentation of RDOS error messages. 
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NOT LOGGED ON 

OPEN ERROR: RDOS message’: filename 
PRINTER IS IN USE 

QUEUE IS FULL 

READ ERROR: RDOS message’: filename 
REQUIRED PARAMETER MISSING 
SPECIFIED JOB NOT FOUND 

TASK INITIATION ERROR: RDOS message* 
UNABLE TO INITIALIZE LINE 

UNDEFINED ERROR CODE 

WRITE ERROR: RDOS neesdge’ filename 


TRefer to Data General documentation of RDOS error messages. 
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HARDWARE STATUS MESSAGES 


MODEM NOT READY 


FORMAT: | MODEM NOT READY 
Communications line is active but the modem is not ready 
(concentrator or remote station only). 


PARITY ERROR 


FORMAT: ” mode E=t R=m S=synbits A=addr 
n Number of errors 
mode OFF, FIRST, or SCAN 


t Error type: 


C - correctable 
U - uncorrectable 


m Read mode: 
S - scaler 
I - 1/0 
V - vector 
F - fetch 


synbits Syndrome bits (0 - 377.) 
addr Parity error address (0 - 3777777.) 
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Cray Research, Inc. 
Corporate Addresses 


General Offices 


Corporate Headquarters 
1440 Northland Drive 
Mendota Heights, Minnesota 55120 
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Manufacturing 
Industrial Park 
Chippewa Falls, Wisconsin 54279 


Sales Offices 


Domestic 

Eastern Regional Sales 

10750 Columbia Pike, Suite 602 . 
Silver Spring, Maryland 20901 
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Central Regional Sales 
1440 Northland Drive 
Mendota Heights, Minnesota 55120 
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Mountain Regional Sales 
75 Manhattan Drive, Suite 3 
Boulder, Colorado 80303 


Houston District (Petroleum) 
3121 Buffalo Speedway, Suite 400 
Houston, Texas 77098 
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Western Regional Sales 


1010 Continenta! Boulevard, Suite 456 


El Segundo, California 90245 


Seattle District 
536A Medical and Dental Building 
Everett, Washington 98201 
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International 

Cray Research (U.K.) Limited 
James Glaisher House 
Grenville Place 

Bracknell, England 
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